1. Node.js 服务端接 MongoDB 时配置到底该放哪做 Node.js 后端项目MongoDB 几乎是绕不开的一环。但真正落到工程里麻烦的往往不是写 CRUD而是配置散落各处数据库连接串写在app.js里模型定义写在models/下密钥又硬编码在某个工具文件里。项目一上规模换环境、换 Key、换模型通道就得满仓库找字符串。这篇聚焦一个具体场景Node.js 服务端项目接入 MongoDB 时如何用一份可复制的settings.json骨架把数据库连接、模型通道 Key、运行参数统一收口并通过 TaoToken 的 API 通道完成一次真实的连通性验证。适合已经会写 Node.js、正在把项目从「能跑」往「好维护」推进的后端开发者。TaoToken 在这里扮演的角色是统一 Key/API 通道你不用在代码里散落多个供应商的地址和密钥而是通过一个入口拿到模型能力配置集中、切换成本低。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。我试过把配置拆成「数据库层」和「模型通道层」两块前者管 MongoDB后者管 TaoToken两边都从settings.json读环境变量做覆盖。下面按这个思路一步步来。2. 前置准备MongoDB 跑起来TaoToken Key 拿到手2.1 本地 MongoDB 启动与关闭先确认 MongoDB 可用。最基础的启动方式指定数据目录和端口mongod --dbpath/data/db --port27017开发机上更常用守护进程方式日志单独落盘方便排查mongod --dbpath/data/db --port27017 --fork --logpath/var/log/mongod.log需要停掉时mongod --shutdown启动后可以用mongosh连一下确认 27017 端口在监听。这一步别跳过后面 Node.js 连不上八成是这里没起来。2.2 拿到 TaoToken 的 API Key进入控制台创建 Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建后复制那串 Key注意它只完整显示一次先存到安全的地方。如果你后面要做长期编码或 Agent 类任务可以看下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。只是想先验证模型通不通用模型对话页就够了https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Key 的管理入口在 API Keys 页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。3. settings.json 骨架数据库与模型通道分层3.1 目录结构约定我习惯把配置放在项目根的config/下settings.json只放非敏感默认值敏感项走环境变量project/ ├── config/ │ └── settings.json ├── src/ │ ├── db.js │ └── llm.js ├── .env └── package.json3.2 可复制的 settings.json{ server: { port: 3000, env: development }, mongodb: { uri: mongodb://localhost:27017/nodejs, options: { serverSelectionTimeoutMS: 5000, maxPoolSize: 10 } }, taotoken: { baseUrl: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, defaultModel: claude-sonnet-4-5, timeoutMs: 30000 } }几个关键点说明。mongodb.uri给的是本地默认值生产环境用环境变量覆盖。serverSelectionTimeoutMS设 5 秒避免连不上时干等。taotoken.apiKeyEnv存的是「环境变量名」而不是 Key 本身这样settings.json可以进版本库Key 留在.env里。3.3 环境变量注入.env文件TAOTOKEN_API_KEYsk-你的Key MONGODB_URImongodb://localhost:27017/nodejs NODE_ENVdevelopment加载逻辑用dotenv在入口最顶部执行require(dotenv).config(); const settings require(./config/settings.json); const mongoUri process.env.MONGODB_URI || settings.mongodb.uri; const apiKey process.env[settings.taotoken.apiKeyEnv];这样本地开发读.env线上读容器注入的环境变量settings.json始终是那份骨架不用改。4. 连通性验证一次请求同时打通 MongoDB 与 TaoToken4.1 用 mongoose 连接并写入先装依赖npm install mongoose dotenvsrc/db.jsconst mongoose require(mongoose); const settings require(../config/settings.json); async function connectDB() { const uri process.env.MONGODB_URI || settings.mongodb.uri; await mongoose.connect(uri, settings.mongodb.options); console.log([db] connected:, uri); } const BookSchema new mongoose.Schema({ name: String, author: String, publishTime: Date }); const Book mongoose.model(Book, BookSchema); module.exports { connectDB, Book };4.2 调用 TaoToken 通道src/llm.jsconst settings require(../config/settings.json); async function askModel(prompt) { const apiKey process.env[settings.taotoken.apiKeyEnv]; const res await fetch(${settings.taotoken.baseUrl}/v1/messages, { method: POST, headers: { Content-Type: application/json, x-api-key: apiKey, anthropic-version: 2023-06-01 }, body: JSON.stringify({ model: settings.taotoken.defaultModel, max_tokens: 256, messages: [{ role: user, content: prompt }] }) }); if (!res.ok) { throw new Error(TaoToken ${res.status}: ${await res.text()}); } return res.json(); } module.exports { askModel };4.3 串起来的验证脚本verify.jsrequire(dotenv).config(); const { connectDB, Book } require(./src/db); const { askModel } require(./src/llm); (async () { await connectDB(); const saved await Book.create({ name: Node.js 实战, author: demo, publishTime: new Date() }); console.log([db] inserted:, saved._id.toString()); const found await Book.findById(saved._id); console.log([db] read back:, found.name); const reply await askModel(用一句话说明 MongoDB 适合什么场景); console.log([llm] reply:, JSON.stringify(reply).slice(0, 200)); process.exit(0); })().catch((err) { console.error([verify] failed:, err.message); process.exit(1); });执行node verify.js预期输出类似[db] connected: mongodb://localhost:27017/nodejs [db] inserted: 66f1a2... [db] read back: Node.js 实战 [llm] reply: {id:msg_...,content:[...]}看到inserted和read back两行说明 MongoDB 读写通了看到reply有内容说明 TaoToken 通道也通了。一次脚本同时验证两条链路比分开测省事。5. 本篇常见错排查5.1 MongoServerSelectionError报错长这样MongooseServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017原因基本是 MongoDB 没启动或者端口不对。先mongosh连一下确认。如果用了 Docker注意容器端口映射。serverSelectionTimeoutMS设小一点能让你更快看到这个错而不是卡住。5.2 401 或 invalid api keyTaoToken 返回 401先检查process.env.TAOTOKEN_API_KEY是否真的读到了。常见坑是.env没被dotenv加载或者变量名和settings.json里的apiKeyEnv对不上。打印一下Object.keys(process.env).filter(k k.includes(TAOTOKEN))就能确认。5.3 模型名不存在如果返回模型相关错误去模型对话页确认当前可用的模型标识https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。settings.json里的defaultModel要和实际可用的一致别照抄旧文档里的名字。5.4 写入成功但读不到Book.create成功、findById返回 null通常是连到了不同的数据库。检查uri里的库名mongodb://localhost:27017/nodejs和mongodb://localhost:27017/test是两个库。用mongosh进去show dbs看一眼就清楚了。5.5 环境变量覆盖没生效settings.json里写了默认值.env里也写了结果用的是默认值。检查加载顺序dotenv必须在读取settings.json之前执行。如果用了 ESMimport会被提升得改用dotenv/config或在入口最前面手动加载。6. 把配置收口后续换环境不再翻仓库这套骨架跑通后你手里其实有了一个可复用的模式settings.json管结构环境变量管敏感值db.js和llm.js各自封装一层。以后换数据库地址、换模型通道、加新模型都只动配置不动业务代码。需要创建或轮换 Key去 API Keys 页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入参数和鉴权细节以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你在做长期编码任务或 Agent 类项目Coding Plan 会更合适https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个实用习惯把verify.js留在仓库里每次改完配置先跑一遍。它比任何文档都诚实两条链路通不通三秒见分晓。
