https://muioo.github.io/tags/codex%E5%90%AF%E5%8A%A8%E6%8A%A5%E9%94%99/Recent content in Codex启动报错 on muioo blogHugo -- gohugo.ioen-usmuiooThu, 17 Sep 2026 00:00:00 +0000https://muioo.github.io/p/codex%E6%8A%A5%E9%94%99codex%E5%87%BA%E7%8E%B0%E6%8A%A5%E9%94%99%E5%90%AF%E5%8A%A8%E5%A4%B1%E8%B4%A5/Thu, 17 Sep 2026 00:00:00 +0000https://muioo.github.io/p/codex%E6%8A%A5%E9%94%99codex%E5%87%BA%E7%8E%B0%E6%8A%A5%E9%94%99%E5%90%AF%E5%8A%A8%E5%A4%B1%E8%B4%A5/<p>参考链接：https://github.com/openai/codex/issues/30105</p> <blockquote> <p><strong>多个 Codex 客户端（ChatGPT 桌面端 + VSCode IDE Codex 插件 + codex-cli）共用同一个 <code>~/.codex</code> 目录，会各自独立启动 app-server 进程</strong> 其中一个进程锁住了 <code>logs_2.sqlite</code>（连带 wal/shm 文件）；<strong>其他 Codex 实例启动时，初始化阶段要打开这个日志库，文件被锁 → 直接启动失败</strong></p> <p>⚠️重点：<strong>数据库本身没有损坏！<code>PRAGMA integrity_check</code>验证 DB 完好</strong>，不是 sqlite 文件坏了，只是并发抢占锁。</p> <p>这个<code>logs_2.sqlite</code>只是诊断日志库，但被放在<strong>关键启动链路</strong>上，一旦拿不到锁，整个 ChatGPT 桌面直接拒绝启动，弹窗提示<code>failed to initialize sqlite state runtime</code>。</p> </blockquote> <h3 id="触发条件">触发条件 </h3><ol> <li>同时跑多个 Codex 客户端：桌面 ChatGPT、VSCode Codex 插件、codex 命令行工具</li> <li>旧版本 Codex（你当前 Windows 客户端版本）<strong>没有内置锁等待 / 优雅降级</strong>，一旦<code>logs_2.sqlite</code>被占用，握手超时直接退出</li> <li>大体积<code>logs_2.sqlite</code>会加剧初始化慢、更容易超时锁失败（你的 Windows 环境也会出现）</li> </ol> <h3 id="出现问题截图">出现问题截图 </h3><p><img src="https://muioo.github.io/p/codex%E6%8A%A5%E9%94%99codex%E5%87%BA%E7%8E%B0%E6%8A%A5%E9%94%99%E5%90%AF%E5%8A%A8%E5%A4%B1%E8%B4%A5/image-20260917101326605.png" width="482" height="160" srcset="https://muioo.github.io/p/codex%E6%8A%A5%E9%94%99codex%E5%87%BA%E7%8E%B0%E6%8A%A5%E9%94%99%E5%90%AF%E5%8A%A8%E5%A4%B1%E8%B4%A5/image-20260917101326605_hu_72844239807efb41.png 480w, https://muioo.github.io/p/codex%E6%8A%A5%E9%94%99codex%E5%87%BA%E7%8E%B0%E6%8A%A5%E9%94%99%E5%90%AF%E5%8A%A8%E5%A4%B1%E8%B4%A5/image-20260917101326605_hu_ff42ab4020df8b07.png 1024w" loading="lazy" alt="image-20260917101326605" class="gallery-image" data-flex-grow="301" data-flex-basis="723px" ></p> <h2 id="-最简修复方案不需要删除--重命名codex不会丢本地数据">✅ 最简修复方案（不需要删除 / 重命名.codex，不会丢本地数据） </h2><blockquote> <p>不需要备份重建！只找到占用<code>logs_2.sqlite</code>的进程 kill 掉即可</p> </blockquote> <h3 id="windows-操作">Windows 操作 </h3><ol> <li>关闭 VSCode（<strong>重点！VSCode 里的 Codex 插件会后台跑 codex app-server，就是锁文件元凶</strong>）</li> <li>任务管理器 → 详细信息，杀掉所有 <code>codex.exe</code>、<code>ChatGPT.exe</code> 进程</li> <li>再启动 ChatGPT 桌面端</li> </ol> <blockquote> <p>如果你不想每次关 VSCode：<strong>不要同时开多个 Codex 客户端共用同一个<code>.codex</code>目录</strong> 可选方案：给不同客户端设置独立<code>CODEX_HOME</code>环境变量，分开存储，避免抢同一个 sqlite 库。</p> </blockquote> <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-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1">#用下面taskkill强制清理所有codex进程</span> </span></span><span class="line"><span class="cl">taskkill /IM codex.exe /F </span></span><span class="line"><span class="cl">taskkill /IM ChatGPT.exe /F </span></span></code></pre></td></tr></table> </div> </div><h2 id="-临时规避长期使用">✅ 临时规避（长期使用） </h2><ol> <li><strong>不要同时打开 VSCode（Codex 插件）+ ChatGPT 桌面端</strong>，这是最高频场景</li> <li>更新 ChatGPT 桌面客户端到新版：新版本增加了 SQLite WAL 配置 + 5s busy 超时，锁冲突概率下降，但<strong>依然没有完全解决</strong>，锁严重时还是会报错</li> <li>终极根治（官方还未合并这个 PR）：官方待合入补丁是把<code>logs_2.sqlite</code>改成<strong>非致命、懒加载</strong>，日志库打不开就降级使用内存临时日志，不再阻断程序启动。</li> </ol> <h2 id="-补充说明">✅ 补充说明 </h2><ol> <li>报错弹窗文字很坑：只提示 “无法初始化 sqlite”，<strong>不会告诉你是 logs_2.sqlite 被别的进程锁住</strong>，这是日志打印层面代码缺陷，底层 sqlite 错误码没有透出到弹窗。</li> <li>不要上来就删除整个<code>.codex</code>文件夹，会丢失本地缓存，<strong>数据库本身完好，仅仅是文件锁竞争</strong>。</li> </ol> <h2 id="推荐使用习惯">推荐使用习惯 </h2><ul> <li>只用<strong>一个 Codex 客户端</strong>访问<code>.codex</code>，要么 VSCode 插件，要么 ChatGPT 桌面，不同时开</li> <li>如果需要同时使用：配置独立<code>CODEX_HOME</code>环境变量，隔离存储目录</li> </ul>