mongoose.connect 连不上控制台只回你一行 error这种排障最折磨人。Node 环境里照着原文写完mongoose.connect(mongodb://127.0.0.1:27017/students)也挂了db.on(error)可错误信息短得看不出是协议、host、port、库名写错还是本地 mongo 根本没起。把报错贴给走 TaoToken 的 Codex 对照是我目前最顺的定位方式动手前先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建 API Key把 Key 填进 CodexBase URL 填 https://taotoken.net/api后面再回到你本地的 mongoose 代码逐项核对。TaoToken 在这里只负责供 Key 和统一 API 通道排查仍然由你本地的 mongo 与 Codex 对话完成。Codex 不会替你启动数据库也不会直接连你的生产库它只读你贴过去的代码、报错、版本号然后对着原文里 connect 那几行和db.on回调帮你缩小范围。1. mongoose.connect 只吐一行 error先把报错和版本凑齐1.1 连接阶段和 save 阶段报错位置不一样很多人把db.on(error)和user.save().catch()混在一起看结果定位方向一开始就偏。mongoose.connect阶段的错误通常走连接对象的error事件比如 mongo 没起、端口不通、连接串协议写错save阶段的错误通常走 Promise 的catch比如 Schema 校验失败、唯一索引冲突、集合写入被拒绝。先分清报错是从哪一行打印出来的再决定把哪段代码贴给 Codex。可以先把两个出口都加上明显前缀const mongoose require(mongoose); mongoose.connect(mongodb://127.0.0.1:27017/students); const db mongoose.connection; db.on(error, (err) { console.log([connect error], err.message); console.log([connect stack], err.stack); }); db.on(open, () { console.log([connect open] 数据库已连接); });这样控制台再吐一行你至少知道是连接阶段还是写入阶段。1.2 贴给 Codex 之前先准备这四样东西把半截报错和一句“连不上”丢给 Codex它只能猜。更有效的方式是准备四样东西完整报错文本、Node 版本、mongoose 版本、相关代码块。Node 版本用node -vmongoose 版本用npm ls mongoose代码块至少包含require(mongoose)、mongoose.connect(...)、mongoose.connection上的事件监听、Schema/Model 定义以及最后save()的调用。例如你可以把下面这些一次性贴过去Node: v20.11.0 mongoose: 8.x 报错 [connect error] connect ECONNREFUSED 127.0.0.1:27017 代码 const mongoose require(mongoose); mongoose.connect(mongodb://127.0.0.1:27017/students); const db mongoose.connection; db.on(error, (err) console.log(err.message)); db.on(open, () console.log(数据库已连接));Codex 拿到这些才能对着原文里“协议://host:port/数据库名”的顺序检查而不是泛泛地说“检查连接”。1.3 TaoToken 在这一步只负责供 Key 和通道打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建 API Key然后把 Key 填进 Codex。接口 Base URL 写https://taotoken.net/api末尾不要加/v1也不要带官网那串utm参数。模型 ID 不要凭记忆写以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场当时列表为准。TaoToken 在这个排障流程里不碰你的 mongo也不执行任何数据库操作它只是让 Codex 有一个稳定的统一 API 通道来读代码、解释报错。2. 在 ~/.codex/config.toml 里把 Codex 指向 TaoToken2.1 安装 Codex 后先确认配置文件位置Codex 安装完成后先执行codex --version确认命令可用再找~/.codex/config.toml。Windows 下通常在用户目录的.codex文件夹里macOS 和 Linux 在~/.codex/。如果这个文件不存在新建一个空文件即可不要动别的项目配置。确认位置之后先备份一份原文件再写入自定义供应商。2.2 model_provider 和 base_url 的正确写法Codex 用的是model_provider加[model_providers.xxx]的结构不要把 Claude Code 的ANTHROPIC_*环境变量套过来。下面是一份可复制的配置示例把YOUR_MODEL_ID换成模型广场里的实际模型 ID# ~/.codex/config.toml model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY然后在终端里设置环境变量Key 从 TaoToken 控制台创建export TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell 用$env:TAOTOKEN_API_KEYYOUR_API_KEY。配置完先让 Codex 回一句普通消息确认它能正常调用再拿它去看 mongoose 报错。2.3 不要往 Codex 里套 ANTHROPIC_ 变量常见错误是搜到 Claude Code 的配置教程就把ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL写进 Codex 的配置文件。Codex 不读这些变量它读的是model_provider和[model_providers.]。同样Base URL 只填https://taotoken.net/api不要在末尾补/v1更不要把官网地址后面的utm_source混进接口地址。接口地址和落地页地址是两个用途落地页用来注册、创建 Key、看模型广场接口地址只填进工具。3. 对照原文 connect 那几行协议、host、port、库名逐项过3.1 连接串四段拆开看错一段就只报一行原文的连接串是mongodb://127.0.0.1:27017/students拆开就是四段协议mongodb://、host127.0.0.1、port27017、库名students。新手最容易错的是协议写成http://或mongodb//host 写成localhost但本地 hosts 解析异常port 写成27018或干脆漏掉库名写成student而脚本里又按students查。任何一段错控制台都可能只给一行连接失败看不出具体根因。把下面这段当作对照模板逐项打勾const mongoose require(mongoose); // 协议://host:port/数据库名 mongoose.connect(mongodb://127.0.0.1:27017/students); const db mongoose.connection; db.on(error, (err) { console.log([connect error], err.message); }); db.on(open, () { console.log([connect open] 数据库已连接); });如果错误是ECONNREFUSED优先看 host 和 port如果是MongooseError: Invalid schema之类方向就要转到 Schema 定义。3.2 mongoose.connection 与 db.on 回调到底该打印什么原文用let db mongoose.connection;拿到连接对象然后挂error和open。这段代码本身没错但很多人只写console.log(err)控制台把错误对象折叠成一行看起来就像只有error。把err.message和err.stack分开打印能多拿到不少线索。open回调里也不要只写console.log(ok)明确打印“数据库已连接”这样你能一眼确认连接阶段是否已经通过。贴给 Codex 时把这几个回调的代码一起给过去让它检查你有没有把监听挂错对象或者有没有在connect之前就引用db。3.3 让 Codex 读你的连接串而不是让它猜可以这样给 Codex 下指令这是我的 Node 版本、mongoose 版本、connect 代码和完整报错请按协议、host、port、库名四段逐项核对并对照db.on(error)与db.on(open)回调指出最可能出错的顺序。Codex 会给你一份检查清单比如先用本地终端确认 27017 是否监听再确认库名是否和后续mongoose.model的集合名冲突。它不会直接连你的 mongo执行仍然在本地。4. Schema/Model 没问题save 却没进 users 集合4.1 mongoose.model(User) 到集合 users 的转换规则原文特别强调过Mongoose 默认把模型名转成小写复数形式。mongoose.model(User, stuSchema)在 mongo 里对应的集合是users。很多人本地用db.users.find()查不到刚保存的文档第一反应是 save 失败实际是集合名没对上要么模型名写成了别的要么在 mongo 里查了user单数集合。排查时先确认模型名和集合名的映射关系。const stuSchema mongoose.Schema({ username: { type: String, lowercase: true }, age: { type: Number, min: 0 } }, { versionKey: false }); const User mongoose.model(User, stuSchema); const user new User({ username: Hauhua, age: 13 }); user.save() .then((doc) { console.log([save ok], doc); }) .catch((err) { console.log([save error], err.message); });4.2 save().then/.catch 里要看的字段then里打印的doc应该能看到_id、username、age如果 Schema 里开了timestamps还会多出createdAt和updatedAt。catch里不要只打印err把err.message和err.errors都打出来。Schema 校验失败时err.errors会告诉你哪个字段没过。把这些输出连同 Schema 定义一起贴给 Codex让它对照原文里的常规参数、type 字段参数、索引参数看看是不是required、min、lowercase、unique某一项写得太严。4.3 Schema 选项写错时Codex 能帮你对出哪一行原文列过versionKey、timestamps、autoIndex等 options。比如你写了{ versionKey: false }保存后就不该出现__v如果你看到__v说明 options 没生效或者写在了错误的位置。Codex 可以对照你的 Schema 定义和实际保存结果指出 options 应该放在第二个参数里而不是混进字段定义。注意这一步仍然是读代码、给建议执行保存和查询还是在你本地完成。5. 本地 mongo 没起时报错和排查动作长什么样5.1 在本地终端确认 mongo 进程和端口mongoose.connect报ECONNREFUSED 127.0.0.1:27017最常见的原因不是代码而是本地 mongo 没起。在本地终端执行mongo或mongosh看能不能进入交互界面如果命令不存在说明服务端工具没装或没进 PATH。Windows 可以在服务列表里看 MongoDB 服务是否运行macOS 可以看brew services listLinux 可以看systemctl status mongod。端口可以用netstat -ano | findstr 27017或lsof -i :27017确认。这一步必须由你在本地执行不要问 Codex“你帮我连一下数据库”。Codex 不会连你的本地 mongo也不应该连你的生产库。你只需要把执行结果复制回对话。5.2 把本地执行结果贴回对话别让 Codex 替你连库如果本地mongo能进执行show dbs再执行use students和db.users.find()把输出贴回对话。如果本地进不去把完整报错贴回去。Codex 会帮你判断是 mongo 服务没启动、端口被占、还是连接串写错。这个桥接关系要固定Codex 生成或解释排查命令你在本地执行再把结果贴回对话。任何“让 Codex 直接连上 mongo 执行诊断”的想法都会把简单问题复杂化也不符合安全边界。6. 修完回到 save 验证then 打印和 users 集合都要对6.1 重新跑一遍 Node 脚本看 then 里的文档连接串改对、本地 mongo 起好之后重新跑 Node 脚本。先看db.on(open)有没有打印“数据库已连接”再看user.save().then里的doc。doc里有_id说明写入已经发生。然后到本地 mongo 里执行use students和db.users.find()确认那条文档真的落在users集合。如果then有输出但 mongo 里查不到再回头看库名和集合名而不是继续改连接串。6.2 去控制台对一下这次调用和 Key 的用量Codex 能帮你对照代码调用本身会走 TaoToken 的 API 通道。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 进控制台看看这次排查产生的调用是否记上账顺便确认 Key 没有填错、模型 ID 没有过期。如果打算把 Codex 长期用于这类代码对照可以看看套餐是否够用。Key 统一在控制台创建不要在项目代码里硬编码。6.3 下一步模型对话、Coding Plan 和创建 Key等users集合里能看到那条文档可以再去 TaoToken 模型对话 用同一把 Key 发一条测试消息确认通道和模型 ID 都没问题。要长期写代码可以打开 Coding Plan 看套餐Key 在 控制台 API Keys 创建。下次再遇到mongoose.connect只吐一行 error先把报错、版本、连接串和 Schema 定义凑齐再让 Codex 按协议、host、port、库名四段逐项核对比反复重启 mongo 有效得多。