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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api 。它的核心价值是：你只需要一个 Key，就能调用多个模型，接口格式兼容常见的 OpenAI 风格，所以已有的代码改动量很小。
具体操作分三步。第一步，打开官网注册并登录，进入控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，在 API Keys 页面创建一个 Key，复制保存好，这个 Key 只显示一次。第二步，如果你要用在编码工具里（比如 Cline、Continue 这类），可以在 Coding Plan 页面 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 查看套餐和接入方式。第三步，想先验证模型通不通，直接去模型对话页面 https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 发一条消息试试。
这里要强调一个概念：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_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，遇到参数问题可以对照查。
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.js：
require("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_URI=mongodb://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 自动生成的，后面删除和修改都要用它。
修改接口，把价格改成 359：
curl -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_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 让模型帮你分析，比搜索引擎快。
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/api，Key 有没有多余空格，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.error：
const data = await res.json(); if (data.error) { console.log("调用失败:", data.error.message); return; } console.log(data.choices[0].message.content);报错六：OAuth / token expired
如果你用的是需要 OAuth 的工具（比如某些 CLI），token 过期后会报这个。重新走一遍授权流程，或者在控制台重新生成 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.js，Key 从环境变量读，这样调试代码和业务代码分离，不会互相干扰。需要生成测试数据时，直接让模型按你的 Schema 输出 JSON 数组，粘进数据库就行。
这套模板的价值在于：结构清晰、每个文件职责单一、报错可定位。你后面加图片上传、加分类、加用户鉴权，都可以在这个骨架上扩展，不用推倒重来。接口调试链路理顺之后，写业务代码的效率会明显不一样。
