https://blog.cpdd.fyi/tags/%E6%95%85%E9%9A%9C%E4%BF%AE%E5%A4%8D/Recent content in 故障修复 on Zampo BlogHugozh-cnWed, 27 May 2026 11:10:00 +0800https://blog.cpdd.fyi/posts/hermes-codex-fix-tutorial/Wed, 27 May 2026 11:10:00 +0800https://blog.cpdd.fyi/posts/hermes-codex-fix-tutorial/<p>你只是让 Hermes 回一句 <code>ping</code>，它却开始连续 fallback。</p> <p>日志里反复出现这几行：</p> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt">1 </span><span class="lnt">2 </span><span class="lnt">3 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">Provider: openai-codex Model: gpt-5.5 </span></span><span class="line"><span class="cl">TypeError: &#39;NoneType&#39; object is not iterable </span></span><span class="line"><span class="cl">trying fallback... </span></span></code></pre></td></tr></table> </div> </div><p>这时候最容易做错一件事：开始重装 Hermes、重配 token、怀疑自己的 profile 坏了。</p> <p>先别急。</p> <p>今天这类报错，大概率不是你本地配置突然失忆，而是 Codex 后端返回流和 <code>openai-python</code> 解析逻辑撞上了一个兼容坑。</p> <p><img src="https://blog.cpdd.fyi/images/hermes-codex-fix-tutorial/cover.png" alt="Hermes Codex/OpenAI 快速止血教程"></p> <p>今天先别重装 Hermes，先绕开 Codex 这颗雷。</p> <h2 id="这次到底坏在哪">这次到底坏在哪</h2> <p>把故障链路压短一点说：</p> <p><code>openai-codex</code> 通过 Codex Responses API 流式返回结果时，前面的 <code>response.output_item.done</code> 事件里已经带了输出内容，但最后的 <code>response.completed</code> 事件里，<code>response.output</code> 可能是 <code>null</code>。</p> <p>问题来了。</p> <p><code>openai-python</code> 的 Responses stream accumulator 在处理 completed 事件时，会把最终 response 交给 <code>parse_response()</code>。而解析函数里有一段逻辑等价于：</p> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt">1 </span><span class="lnt">2 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="k">for</span> <span class="n">output</span> <span class="ow">in</span> <span class="n">response</span><span class="o">.</span><span class="n">output</span><span class="p">:</span> </span></span><span class="line"><span class="cl"> <span class="o">...</span> </span></span></code></pre></td></tr></table> </div> </div><p>如果 <code>response.output</code> 是 <code>None</code>，Python 就会直接炸：</p>