1. Express MongoDB 增删改查从零跑通本地调试到联调链路怎么搭如果你正在搜「Express 配合 MongoDB 实现增删改查」大概率是刚学完 Node.js 基础想找一个能直接复制、能跑起来、还能顺手把接口调试链路理顺的完整例子。这篇就按这个目标来用 Express 起服务用 Mongoose 连 MongoDB把商品goods的增删改查五个接口全部写出来再补上接口调试和统一 Key 管理这一环。先说清楚这套东西是什么、能做什么、适合谁。Express 是 Node.js 上的 Web 框架负责把 HTTP 请求接进来、把 JSON 发出去MongoDB 是文档型数据库存的是类似 JSON 的对象Mongoose 是它俩之间的桥用 Schema 定义数据结构用 Model 操作集合。三者组合起来你就能用几十行代码做出一个能增删改查的后端接口服务。适合人群很明确Node.js 后端初学者、想补全栈能力的开发者、以及需要快速搭一个 CRUD 原型验证想法的人。我试过在只装了 Node 的干净环境里从零走一遍踩过的坑集中在三处数据库连不上、req.body 拿不到值、以及接口调不通时不知道是网络问题还是代码问题。所以这篇不会只贴代码会把每一步的验证方式写出来让你在出错时能自己定位。整体链路是这样的先建项目、装依赖再写数据库连接文件然后定义 Schema 和 Model接着在路由里实现五个接口最后用 Postman 或前端 axios 验证。调试阶段如果涉及多模型调用比如让 AI 帮你生成测试数据、解释报错可以用 TaoToken 把多个模型的 Key 统一管理避免在多个平台之间来回切换。下面按顺序展开。2. TaoToken 前置准备统一 Key 打通多模型调用链路在写接口之前先把调试链路准备好。为什么这一步放在前面因为后面你一定会遇到「这个报错到底什么意思」「帮我生成一批测试数据」这类需求如果每次都要去不同平台找 Key、配环境节奏会被打断。TaoToken 的作用就是把这些调用收敛到一个入口。TaoToken 是一个模型调用聚合平台官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的核心价值是你只需要一个 Key就能调用多个模型接口格式兼容常见的 OpenAI 风格所以已有的代码改动量很小。具体操作分三步。第一步打开官网注册并登录进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面创建一个 Key复制保存好这个 Key 只显示一次。第二步如果你要用在编码工具里比如 Cline、Continue 这类可以在 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 查看套餐和接入方式。第三步想先验证模型通不通直接去模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 发一条消息试试。这里要强调一个概念Base URL、Key、Model ID 是三件套缺一不可。Base URL 决定请求发到哪里Key 决定你有没有权限Model ID 决定用哪个模型。后面在配置文件里会反复出现这三个字段先记住这个结构。注意Key 属于敏感信息不要提交到 Git 仓库建议放在.env文件里并用.gitignore排除。本地调试时如果 Key 泄露及时在控制台删除重建。对于本篇的 CRUD 场景TaoToken 主要用在两个地方一是接口调不通时把报错贴给模型让它帮你分析二是需要批量生成测试数据时让模型按你的 Schema 输出 JSON 数组。这两件事都不需要你切换平台一个 Key 就够了。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到参数问题可以对照查。3. 可复制配置Express 项目结构、Mongoose 模型与路由代码这一节是全文的核心所有代码都可以直接复制。先建项目mkdir express-mongo-crud cd express-mongo-crud npm init -y npm i express mongoose npm i -D nodemon然后在package.json里把启动脚本改成用 nodemon方便改代码自动重启{ scripts: { dev: nodemon app.js } }项目结构建议这样组织后面找文件不费劲express-mongo-crud/ ├── app.js ├── model/ │ ├── db.js │ └── model.js ├── routes/ │ └── goods.js └── .env先写数据库连接文件model/db.js。这里用环境变量存连接串比硬编码好维护const mongoose require(mongoose); const uri process.env.MONGO_URI || mongodb://127.0.0.1:27017/shop; mongoose.connect(uri); const conn mongoose.connection; conn.on(open, () { console.log(数据库连接成功); }); conn.on(error, (err) { console.log(数据库连接失败:, err.message); }); module.exports mongoose;注意数据库名shop如果本地已经存在同名库会直接连上去不会新建。这是很多人第一次跑发现「怎么有旧数据」的原因。接着写模型model/model.js。mongoose.model的三个参数分别是模型名、Schema、集合名const mongoose require(./db); const goodsSchema new mongoose.Schema({ title: String, price: Number, stock: { type: Number, default: 0 }, createdAt: { type: Date, default: Date.now } }); const goodsModel mongoose.model(Goods, goodsSchema, goods); module.exports { goodsModel };然后是路由routes/goods.js五个接口一次写全const express require(express); const router express.Router(); const { goodsModel } require(../model/model); // 查询全部 router.get(/getgoods, async (req, res) { const data await goodsModel.find(); res.send({ code: 200, data }); }); // 新增 router.post(/addgoods, async (req, res) { await goodsModel.create(req.body); res.send({ code: 200, msg: 添加成功 }); }); // 删除body 传参 router.post(/delgoods, async (req, res) { const { _id } req.body; await goodsModel.deleteOne({ _id }); res.send({ code: 200, msg: 删除成功 }); }); // 修改 router.post(/editgoods, async (req, res) { const body req.body; await goodsModel.updateOne({ _id: body._id }, body); res.send({ code: 200, msg: 修改成功 }); }); // 模糊搜索 router.get(/search, async (req, res) { const data await goodsModel.find({ title: { $regex: req.query.title } }); res.send({ code: 200, data }); }); module.exports router;最后是入口app.jsrequire(dotenv).config(); const express require(express); const goodsRouter require(./routes/goods); const app express(); app.use(express.json()); app.use(express.urlencoded({ extended: true })); app.use(goodsRouter); app.listen(3000, () { console.log(服务已启动: http://127.0.0.1:3000); });这里express.json()这行必须加否则req.body永远是 undefined这是新手最常见的坑之一。.env文件里写MONGO_URImongodb://127.0.0.1:27017/shop如果你在调试阶段想让 AI 帮你生成测试数据可以在项目里加一个调用脚本三件套配置如下const BASE_URL https://taotoken.net/api; const API_KEY process.env.TAOTOKEN_KEY; const MODEL_ID gpt-4o-mini; async function ask(prompt) { const res await fetch(${BASE_URL}/v1/chat/completions, { method: POST, headers: { Content-Type: application/json, Authorization: Bearer ${API_KEY} }, body: JSON.stringify({ model: MODEL_ID, messages: [{ role: user, content: prompt }] }) }); return res.json(); }Base URL、Key、Model ID 三个字段都在这里换模型只改MODEL_ID即可。4. 验证请求与成功结果五个接口逐个跑通代码写完不算完得逐个验证。启动服务npm run dev看到「数据库连接成功」和「服务已启动」两行日志说明基础链路通了。如果只看到服务启动、没有数据库连接成功说明 MongoDB 没起来先解决这个再往下。新增一条数据用 curl 验证curl -X POST http://127.0.0.1:3000/addgoods \ -H Content-Type: application/json \ -d {title:机械键盘,price:399,stock:10}返回{code:200,msg:添加成功}就对了。查询全部curl http://127.0.0.1:3000/getgoods返回的data数组里应该能看到刚插入的记录带_id、title、price、stock、createdAt字段。这个_id是 MongoDB 自动生成的后面删除和修改都要用它。修改接口把价格改成 359curl -X POST http://127.0.0.1:3000/editgoods \ -H Content-Type: application/json \ -d {_id:把这里换成真实id,title:机械键盘,price:359}注意updateOne的第二个参数直接传整个 body会把_id也当成要更新的字段虽然 MongoDB 不允许改_id所以不会出错但更规范的做法是排除它。删除接口curl -X POST http://127.0.0.1:3000/delgoods \ -H Content-Type: application/json \ -d {_id:把这里换成真实id}模糊搜索curl http://127.0.0.1:3000/search?title键盘只要 title 里包含「键盘」的记录都会被返回。前端用 axios 调用时注意then里拿到的是res.data.data因为后端包了一层{ code, data }。每次增删改后要重新请求列表并渲染否则页面不会自动更新。如果你在验证过程中遇到报错可以把错误信息贴到模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 让模型帮你分析比搜索引擎快。5. 本篇常见报错排查401、local proxy failed、reading choices 怎么解这一节按真实报错来对照遇到问题直接查。报错一MongooseServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017这是数据库没启动。Windows 上检查 MongoDB 服务是否在运行macOS 用brew services list看状态。如果用的是远程连接串检查 IP 白名单和端口是否放行。这个报错和代码无关纯粹是连接层问题。报错二req.body 是 undefined九成是漏了app.use(express.json())。Express 默认不解析 JSON 请求体必须显式加中间件。另外检查请求头有没有带Content-Type: application/json用 Postman 时如果选了 form-data 而不是 raw JSON也会拿不到值。报错三401 Unauthorized / invalid api key这个出现在调用模型接口时。检查三件套Base URL 是不是https://taotoken.net/apiKey 有没有多余空格Model ID 拼写是否正确。如果 Key 是从控制台复制的注意别把前后空格带进去。401 基本都是鉴权问题和网络无关。报错四local proxy failed / connection refused本地代理配置问题。检查你的 HTTP 客户端有没有走系统代理或者环境变量里有没有残留的HTTP_PROXY。在 Node 里可以用delete process.env.HTTP_PROXY临时排除。这个报错说明请求根本没发出去卡在本地网络层。报错五Cannot read properties of undefined (reading choices)这个出现在解析模型返回时。说明返回结构里没有choices字段通常是请求失败返回了错误对象但代码直接按成功结构去取。正确做法是先判断res.ok或检查data.errorconst data await res.json(); if (data.error) { console.log(调用失败:, data.error.message); return; } console.log(data.choices[0].message.content);报错六OAuth / token expired如果你用的是需要 OAuth 的工具比如某些 CLItoken 过期后会报这个。重新走一遍授权流程或者在控制台重新生成 Key。这类报错和代码逻辑无关属于凭证生命周期问题。报错七CastError: Cast to ObjectId failed删除或修改时传的_id格式不对。MongoDB 的_id是 24 位十六进制字符串如果你传了空值或者随便一个字符串就会报这个。检查前端传参时_id有没有正确取到。排查顺序建议先看服务端日志再看请求是否到达最后看数据库操作。大部分问题在前两步就能定位。6. 语义一致收尾把 CRUD 链路固化成可复用模板走到这里五个接口应该都能跑通了。最后说几个让它更耐用的做法。第一把updateOne改成findByIdAndUpdate语义更清晰也不用担心_id被误传router.post(/editgoods, async (req, res) { const { _id, ...rest } req.body; await goodsModel.findByIdAndUpdate(_id, rest); res.send({ code: 200, msg: 修改成功 }); });第二给查询加个分页数据量大了不至于一次全返回router.get(/getgoods, async (req, res) { const page Number(req.query.page) || 1; const size Number(req.query.size) || 10; const data await goodsModel .find() .skip((page - 1) * size) .limit(size); const total await goodsModel.countDocuments(); res.send({ code: 200, data, total }); });第三把模型调用脚本单独放一个utils/ai.jsKey 从环境变量读这样调试代码和业务代码分离不会互相干扰。需要生成测试数据时直接让模型按你的 Schema 输出 JSON 数组粘进数据库就行。这套模板的价值在于结构清晰、每个文件职责单一、报错可定位。你后面加图片上传、加分类、加用户鉴权都可以在这个骨架上扩展不用推倒重来。接口调试链路理顺之后写业务代码的效率会明显不一样。