https://blog.margrop.net/tag/%E5%8A%A8%E6%80%81%E9%93%BE%E6%8E%A5/ Recent content in 动态链接 on 魔都水滴 Hugo -- gohugo.io zh-CN Sat, 23 May 2026 06:10:00 +0800 https://blog.margrop.net/post/codex-mcp-startup-swift-runtime-troubleshooting/ Sat, 23 May 2026 06:10:00 +0800 https://blog.margrop.net/post/codex-mcp-startup-swift-runtime-troubleshooting/ <blockquote> <p><strong>先说结论</strong></p> <p>这次故障最容易误判的地方，是表面错误写着 “MCP Client 启动失败”“MCP Server 握手失败”，于是人很自然会去怀疑 MCP 配置、插件开关、网络、Token、JSON 格式、stdio 协议，甚至怀疑 Codex 本身挂了。但真正的根因并不在 MCP 协议层：某个 MCP Server 对应的本地二进制在启动瞬间就被 macOS 动态链接器杀掉了，根本没有机会完成 <code>initialize</code> 握手。Client 看到的只是连接提前关闭，Server 端真正留下的线索是 <code>dyld: Symbol not found</code>，缺的是 Swift Concurrency runtime 里的一个符号。</p> <p>换句话说：MCP 没有来得及失败，Server 进程先死了。</p> </blockquote> <p>这篇文章记录一次很典型、也很容易绕远路的 Agent 工具链故障：Codex 里 MCP Client / MCP Server 启动异常。它不是一个“修改配置就好”的问题，而是一个从应用层错误一路追到本地二进制、动态链接器、Swift runtime 兼容性的排障过程。</p> <p>为了避免泄露任何隐私信息，本文不包含真实内网地址、真实用户名、真实会话 ID、真实本机绝对路径、Token、私有仓库地址或任何业务系统名称。文中路径都使用 <code>~</code>、<code>&lt;USER_HOME&gt;</code>、<code>&lt;PLUGIN_DIR&gt;</code>、<code>&lt;PROJECT&gt;</code> 等占位符表示；命令输出也只保留与判断根因有关的公开技术字段。</p>