尧图网站建设 
简介这是一套基于 Node.js、Express 与 MongoDB 构建的博客管理系统完整源码前端采用 Vue 实现界面美观、功能齐全适合作为高校毕业设计、课程设计作业或全栈入门练手项目帮助读者快速搭建一套可运行的 Web 应用。压缩包共 675 个文件约 121.62MB其中 241 个 js 文件承载前后端核心逻辑82 个 json 与 7 个 yml 负责依赖与配置123 个 md 文档提供说明另有 gif、png、psd 等界面素材及 css、html、sql 等资源目录结构清晰便于按模块查阅。目前已有 163 人学习下载。读者可从中获得完整的项目源码、数据库脚本与依赖配置直接用于部署运行、二次开发或答辩演示也能借此梳理 Express 路由、MongoDB 数据建模与 Vue 组件化开发的整体思路是兼顾实用性与学习价值的全栈实践参考。1. 从一份 NodejsExpressMongoDB 博客管理系统源码说起它到底能跑出什么很多人第一次拿到「NodejsExpressMongoDB 实现博客管理系统」这类压缩包第一反应是解压、npm install、npm start然后卡在npm : 无法加载文件 ... 因为在此系统上禁止运行脚本上或者 MongoDB 服务根本没起来浏览器一片空白。这套技术栈之所以被反复选作博客系统的实现方案是因为它把「请求路由、业务逻辑、数据持久化」三件事拆得足够干净Express 负责 HTTP 层和中间件编排MongoDB 用文档模型天然贴合文章的富文本结构Node.js 则让前后端共用一套 JavaScript 心智。它适合想从零理解一个完整 CRUD 项目怎么落地的人也适合已经会写页面、但没搭过服务端数据流的开发者。读完你能自己把环境配通、把文章增删改查跑起来、知道哪些参数一改就翻车。2. 环境先跑通Nodejs 安装、MongoDB 启动与依赖装不上的排查2.1 Nodejs 安装及环境配置里最容易忽略的两步Windows 上装 Node.js官网下载 msi 一路下一步就行但有两个点决定了后面会不会翻车。第一是安装路径别带中文和空格默认的C:\Program Files\nodejs\虽然能用但 PowerShell 执行策略会拦npm.ps1报错就是那句经典的npm : 无法加载文件 c:\program files\nodejs\npm.ps1因为在此系统上禁止运行脚本。第二是装完必须重开终端否则node -v读到的还是旧 PATH。Mac 安装 Nodejs 更推荐用版本管理工具避免全局权限问题# 用 nvm 安装并切换 Node 版本避免 sudo 装全局包 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.zshrc # 让 nvm 命令生效 nvm install 20 # 装一个 LTS 版本 nvm use 20 node -v # 应输出 v20.x npm -v逻辑说明nvm 把 Node 装在用户目录下全局包不再需要sudo也就不会出现权限报错。参数上nvm install 20里的 20 是主版本号写--lts也行如果项目package.json里锁了 engines就按它要求的版本装。Windows 上如果坚持用 PowerShell执行策略要放开当前用户# 以管理员身份打开 PowerShell 后执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned # 验证 Get-ExecutionPolicy -Scope CurrentUserRemoteSigned表示本地脚本可跑、远程下载的脚本需签名比Unrestricted安全。改完重开终端npm -v就能正常输出了。2.2 MongoDB 安装失败与本地服务启动的三种姿势MongoDB 安装失败大多不是安装包的问题而是服务注册和 data 目录权限。Windows 上用 msi 装完默认会注册成 Windows 服务但如果你勾掉了「Install MongoDB as a Service」就得手动起。手动起之前先建数据目录# Windows 手动启动 mongod指定数据目录和日志 mkdir C:\data\db C:\Program Files\MongoDB\Server\7.0\bin\mongod.exe --dbpath C:\data\db --logpath C:\data\log\mongod.log逻辑说明--dbpath是数据文件落盘位置必须存在且当前用户有写权限否则报Unable to create/open lock file。--logpath把日志单独写文件方便排查启动失败。Mac 上如果用 Homebrewbrew tap mongodb/brew brew install mongodb-community brew services start mongodb-community # 注册为后台服务 # 或者前台跑方便看日志 mongod --config /opt/homebrew/etc/mongod.conf启动后用mongosh连一下确认mongosh # 进入后执行 show dbs能列出数据库就说明服务通了。这里顺带把 MongoDB 的核心概念对齐一下数据库database相当于一个库集合collection相当于表文档document相当于行但文档是 BSON 结构字段可以嵌套、可以不一致这正是博客文章存标签数组、存富文本块时比关系表舒服的地方。2.3 依赖安装与项目启动的最小命令环境通了之后进项目目录装依赖。国内网络下npm install慢是常态可以换镜像源但别全局改死用项目级.npmrc更稳# 在项目根目录创建 .npmrc只影响当前项目 echo registryhttps://registry.npmmirror.com .npmrc npm install逻辑说明.npmrc里的 registry 只对当前项目生效不会污染全局配置。装完看node_modules是否完整重点确认express、mongoose、dotenv这几个在不在。启动前先配环境变量别把连接串硬编码进代码# .env 文件 PORT3000 MONGO_URImongodb://127.0.0.1:27017/blog SESSION_SECRETchange_this_in_productionMONGO_URI里的blog是数据库名MongoDB 不会因为你写了就立刻建库第一次写入文档时才真正创建。127.0.0.1比localhost在某些系统上解析更快避免 IPv6 优先导致的连接超时。启动命令通常是npm start或node app.js如果package.json里配了 nodemon开发时用npm run dev能热重载。3. Express 路由与中间件把博客的增删改查拆成可维护的层3.1 用 Express 搭出文章 CRUD 的最小路由骨架博客系统的核心就是文章的增删改查Express 的 Router 能把这块拆成独立模块。常见做法是routes/posts.js只负责定义路径和挂控制器业务逻辑放controllers/postController.js数据操作放models/Post.js。先看路由层// routes/posts.js const express require(express); const router express.Router(); const postController require(../controllers/postController); const { requireAuth } require(../middleware/auth); router.get(/, postController.listPosts); // 列表支持分页 router.get(/:id, postController.getPost); // 详情 router.post(/, requireAuth, postController.createPost); // 新建需登录 router.put(/:id, requireAuth, postController.updatePost); // 更新 router.delete(/:id, requireAuth, postController.deletePost); // 删除 module.exports router;逻辑说明requireAuth是中间件放在具体 handler 之前请求会先过鉴权再进业务。/:id是路径参数Express 会把它塞进req.params.id。参数上要注意路由顺序/:id如果写在/archive这类固定路径前面/archive会被当成 id 匹配掉这是新手最常见的翻车点之一。控制器里做参数校验和响应封装// controllers/postController.js const Post require(../models/Post); exports.listPosts async (req, res, next) { try { const page Math.max(parseInt(req.query.page) || 1, 1); const limit Math.min(parseInt(req.query.limit) || 10, 50); // 上限 50防拖库 const skip (page - 1) * limit; const [items, total] await Promise.all([ Post.find().sort({ createdAt: -1 }).skip(skip).limit(limit).lean(), Post.countDocuments() ]); res.json({ code: 0, data: { items, total, page, limit } }); } catch (err) { next(err); // 交给统一错误中间件 } };逻辑说明parseInt后要兜底否则?pageabc会算出NaN导致 skip 报错。limit设上限是防止有人传?limit999999把内存打满。.lean()返回普通对象而不是 Mongoose 文档列表页只读不写时能省一层包装开销。Promise.all让查询和计数并行比串行快。3.2 中间件顺序、错误处理与静态资源托管Express 的中间件是洋葱模型注册顺序决定执行顺序。一个能用的app.js大致长这样// app.js const express require(express); const mongoose require(mongoose); require(dotenv).config(); const app express(); app.use(express.json({ limit: 1mb })); // 解析 JSON body app.use(express.urlencoded({ extended: true })); // 解析表单 app.use(/uploads, express.static(public/uploads)); // 静态资源 app.use(/api/posts, require(./routes/posts)); // 统一错误处理必须放最后且四个参数不能少 app.use((err, req, res, next) { console.error(err.stack); res.status(err.status || 500).json({ code: 1, message: err.message }); }); mongoose.connect(process.env.MONGO_URI) .then(() app.listen(process.env.PORT || 3000, () console.log(server up))) .catch(err { console.error(mongo connect failed, err); process.exit(1); });逻辑说明express.json的limit默认 100kb博客提交富文本很容易超调到1mb是常见值再大要考虑分片上传。错误处理中间件必须放在所有路由之后且形参是四个少一个 Express 就不认它是错误处理器。mongoose.connect失败时直接process.exit(1)避免服务半死不活地挂着比让它静默重试更好排查。3.3 Mongoose 模型设计文章、分类、评论怎么关联MongoDB 是文档型但博客里文章和评论、文章和分类之间仍有引用关系。常见做法是文章存分类的 ObjectId 引用评论单独一个集合存文章 id// models/Post.js const mongoose require(mongoose); const postSchema new mongoose.Schema({ title: { type: String, required: true, trim: true, maxlength: 120 }, content: { type: String, required: true }, tags: [{ type: String, trim: true }], category: { type: mongoose.Schema.Types.ObjectId, ref: Category }, author: { type: mongoose.Schema.Types.ObjectId, ref: User, required: true }, status: { type: String, enum: [draft, published], default: draft }, views: { type: Number, default: 0 } }, { timestamps: true }); postSchema.index({ title: text, content: text }); // 全文索引 module.exports mongoose.model(Post, postSchema);逻辑说明ref声明引用关系查询时用.populate(category)把关联文档填进来。timestamps: true自动维护createdAt和updatedAt省得自己写。index建全文索引后可以用$text查询但注意一个集合只能有一个文本索引字段多了索引会变大写入也会变慢。enum限制状态值避免脏数据进库。4. 避坑与排查这套博客系统最容易翻车的五个地方4.1 连不上 MongoDB先看服务再看连接串现象启动报MongooseServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017。原因通常是 mongod 没起或者连接串端口写错。解决先mongosh确认能连再看.env里的MONGO_URI端口是否和 mongod 实际监听一致。如果 mongod 起了还连不上检查是不是绑定了bindIp: 127.0.0.1而你在用容器或远程地址访问。4.2 npm 脚本被拦PowerShell 执行策略的锅现象npm run dev报因为在此系统上禁止运行脚本。原因Windows PowerShell 默认执行策略是Restricted拦了npm.ps1。解决Set-ExecutionPolicy -Scope CurrentUser RemoteSigned或者改用 CMD 执行。别直接上Unrestricted那等于把脚本执行全放开。4.3 路由 404路径顺序和挂载前缀对不上现象访问/api/posts/archive返回 404 或进了详情接口。原因/:id定义在固定路径之前或者app.use挂载前缀和前端请求路径不一致。解决固定路径写在参数路径前面用req.originalUrl打日志确认实际进来的路径前端请求 baseURL 和app.use前缀对齐。4.4 提交大文章报 413body 体积超限现象发布长文返回PayloadTooLargeError或 413。原因express.json默认 limit 100kb。解决调大 limit但别无脑调到50mb按业务实际最大文章体积设同时前端做字数提示。如果文章带图片图片走单独上传接口别塞进 JSON。4.5 查询越来越慢缺索引和全表扫描现象文章列表页加载从几百毫秒涨到几秒。原因按createdAt排序但没建索引数据量上来后全集合扫描。解决给常用查询字段建索引postSchema.index({ createdAt: -1 })用explain(executionStats)看是否走了索引totalDocsExamined远大于返回条数就说明没走。5. 进阶用聚合管道做归档统计以及上线前该验证什么列表和详情跑通只是及格线博客系统真正体现 MongoDB 价值的地方是聚合统计。比如按年月归档文章数量用$group一步到位// 按年月统计已发布文章数 const stats await Post.aggregate([ { $match: { status: published } }, { $group: { _id: { year: { $year: $createdAt }, month: { $month: $createdAt } }, count: { $sum: 1 } }}, { $sort: { _id.year: -1, _id.month: -1 } } ]);逻辑说明$match先过滤能走索引放在管道最前面。$group的_id里用$year、$month从日期字段提取年月。$sort按年月倒序。参数上注意$match里的条件字段如果有索引聚合会快很多如果先$group再$match就没法用索引了。上线前我一般会验证三件事。第一是连接池Mongoose 默认 poolSize 是 100小站够用但要在压测下看serverStatus里的 connections 是否逼近上限。第二是错误日志把console.error换成带时间戳和请求 id 的结构化日志否则线上出问题只能靠猜。第三是数据备份mongodump定时跑别等删库了才想起后悔药# 备份 blog 库到指定目录 mongodump --urimongodb://127.0.0.1:27017/blog --out/backup/$(date %F)这套栈我踩过最深的坑不是代码是环境。同一份源码在别人机器上跑得飞起到自己这儿卡在 PowerShell 执行策略和 MongoDB 服务没注册上折腾一下午。后来我养成习惯拿到任何 Node 项目先node -v、npm -v、mongosh三连确认环境再动代码。希望帮到你。本文还有配套的精品资源点击获取 Nodejs+Express+MongoDB博客管理系统：环境搭建与CRUD实战
简介这是一套基于 Node.js、Express 与 MongoDB 构建的博客管理系统完整源码前端采用 Vue 实现界面美观、功能齐全适合作为高校毕业设计、课程设计作业或全栈入门练手项目帮助读者快速搭建一套可运行的 Web 应用。压缩包共 675 个文件约 121.62MB其中 241 个 js 文件承载前后端核心逻辑82 个 json 与 7 个 yml 负责依赖与配置123 个 md 文档提供说明另有 gif、png、psd 等界面素材及 css、html、sql 等资源目录结构清晰便于按模块查阅。目前已有 163 人学习下载。读者可从中获得完整的项目源码、数据库脚本与依赖配置直接用于部署运行、二次开发或答辩演示也能借此梳理 Express 路由、MongoDB 数据建模与 Vue 组件化开发的整体思路是兼顾实用性与学习价值的全栈实践参考。1. 从一份 NodejsExpressMongoDB 博客管理系统源码说起它到底能跑出什么很多人第一次拿到「NodejsExpressMongoDB 实现博客管理系统」这类压缩包第一反应是解压、npm install、npm start然后卡在npm : 无法加载文件 ... 因为在此系统上禁止运行脚本上或者 MongoDB 服务根本没起来浏览器一片空白。这套技术栈之所以被反复选作博客系统的实现方案是因为它把「请求路由、业务逻辑、数据持久化」三件事拆得足够干净Express 负责 HTTP 层和中间件编排MongoDB 用文档模型天然贴合文章的富文本结构Node.js 则让前后端共用一套 JavaScript 心智。它适合想从零理解一个完整 CRUD 项目怎么落地的人也适合已经会写页面、但没搭过服务端数据流的开发者。读完你能自己把环境配通、把文章增删改查跑起来、知道哪些参数一改就翻车。2. 环境先跑通Nodejs 安装、MongoDB 启动与依赖装不上的排查2.1 Nodejs 安装及环境配置里最容易忽略的两步Windows 上装 Node.js官网下载 msi 一路下一步就行但有两个点决定了后面会不会翻车。第一是安装路径别带中文和空格默认的C:\Program Files\nodejs\虽然能用但 PowerShell 执行策略会拦npm.ps1报错就是那句经典的npm : 无法加载文件 c:\program files\nodejs\npm.ps1因为在此系统上禁止运行脚本。第二是装完必须重开终端否则node -v读到的还是旧 PATH。Mac 安装 Nodejs 更推荐用版本管理工具避免全局权限问题# 用 nvm 安装并切换 Node 版本避免 sudo 装全局包 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.zshrc # 让 nvm 命令生效 nvm install 20 # 装一个 LTS 版本 nvm use 20 node -v # 应输出 v20.x npm -v逻辑说明nvm 把 Node 装在用户目录下全局包不再需要sudo也就不会出现权限报错。参数上nvm install 20里的 20 是主版本号写--lts也行如果项目package.json里锁了 engines就按它要求的版本装。Windows 上如果坚持用 PowerShell执行策略要放开当前用户# 以管理员身份打开 PowerShell 后执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned # 验证 Get-ExecutionPolicy -Scope CurrentUserRemoteSigned表示本地脚本可跑、远程下载的脚本需签名比Unrestricted安全。改完重开终端npm -v就能正常输出了。2.2 MongoDB 安装失败与本地服务启动的三种姿势MongoDB 安装失败大多不是安装包的问题而是服务注册和 data 目录权限。Windows 上用 msi 装完默认会注册成 Windows 服务但如果你勾掉了「Install MongoDB as a Service」就得手动起。手动起之前先建数据目录# Windows 手动启动 mongod指定数据目录和日志 mkdir C:\data\db C:\Program Files\MongoDB\Server\7.0\bin\mongod.exe --dbpath C:\data\db --logpath C:\data\log\mongod.log逻辑说明--dbpath是数据文件落盘位置必须存在且当前用户有写权限否则报Unable to create/open lock file。--logpath把日志单独写文件方便排查启动失败。Mac 上如果用 Homebrewbrew tap mongodb/brew brew install mongodb-community brew services start mongodb-community # 注册为后台服务 # 或者前台跑方便看日志 mongod --config /opt/homebrew/etc/mongod.conf启动后用mongosh连一下确认mongosh # 进入后执行 show dbs能列出数据库就说明服务通了。这里顺带把 MongoDB 的核心概念对齐一下数据库database相当于一个库集合collection相当于表文档document相当于行但文档是 BSON 结构字段可以嵌套、可以不一致这正是博客文章存标签数组、存富文本块时比关系表舒服的地方。2.3 依赖安装与项目启动的最小命令环境通了之后进项目目录装依赖。国内网络下npm install慢是常态可以换镜像源但别全局改死用项目级.npmrc更稳# 在项目根目录创建 .npmrc只影响当前项目 echo registryhttps://registry.npmmirror.com .npmrc npm install逻辑说明.npmrc里的 registry 只对当前项目生效不会污染全局配置。装完看node_modules是否完整重点确认express、mongoose、dotenv这几个在不在。启动前先配环境变量别把连接串硬编码进代码# .env 文件 PORT3000 MONGO_URImongodb://127.0.0.1:27017/blog SESSION_SECRETchange_this_in_productionMONGO_URI里的blog是数据库名MongoDB 不会因为你写了就立刻建库第一次写入文档时才真正创建。127.0.0.1比localhost在某些系统上解析更快避免 IPv6 优先导致的连接超时。启动命令通常是npm start或node app.js如果package.json里配了 nodemon开发时用npm run dev能热重载。3. Express 路由与中间件把博客的增删改查拆成可维护的层3.1 用 Express 搭出文章 CRUD 的最小路由骨架博客系统的核心就是文章的增删改查Express 的 Router 能把这块拆成独立模块。常见做法是routes/posts.js只负责定义路径和挂控制器业务逻辑放controllers/postController.js数据操作放models/Post.js。先看路由层// routes/posts.js const express require(express); const router express.Router(); const postController require(../controllers/postController); const { requireAuth } require(../middleware/auth); router.get(/, postController.listPosts); // 列表支持分页 router.get(/:id, postController.getPost); // 详情 router.post(/, requireAuth, postController.createPost); // 新建需登录 router.put(/:id, requireAuth, postController.updatePost); // 更新 router.delete(/:id, requireAuth, postController.deletePost); // 删除 module.exports router;逻辑说明requireAuth是中间件放在具体 handler 之前请求会先过鉴权再进业务。/:id是路径参数Express 会把它塞进req.params.id。参数上要注意路由顺序/:id如果写在/archive这类固定路径前面/archive会被当成 id 匹配掉这是新手最常见的翻车点之一。控制器里做参数校验和响应封装// controllers/postController.js const Post require(../models/Post); exports.listPosts async (req, res, next) { try { const page Math.max(parseInt(req.query.page) || 1, 1); const limit Math.min(parseInt(req.query.limit) || 10, 50); // 上限 50防拖库 const skip (page - 1) * limit; const [items, total] await Promise.all([ Post.find().sort({ createdAt: -1 }).skip(skip).limit(limit).lean(), Post.countDocuments() ]); res.json({ code: 0, data: { items, total, page, limit } }); } catch (err) { next(err); // 交给统一错误中间件 } };逻辑说明parseInt后要兜底否则?pageabc会算出NaN导致 skip 报错。limit设上限是防止有人传?limit999999把内存打满。.lean()返回普通对象而不是 Mongoose 文档列表页只读不写时能省一层包装开销。Promise.all让查询和计数并行比串行快。3.2 中间件顺序、错误处理与静态资源托管Express 的中间件是洋葱模型注册顺序决定执行顺序。一个能用的app.js大致长这样// app.js const express require(express); const mongoose require(mongoose); require(dotenv).config(); const app express(); app.use(express.json({ limit: 1mb })); // 解析 JSON body app.use(express.urlencoded({ extended: true })); // 解析表单 app.use(/uploads, express.static(public/uploads)); // 静态资源 app.use(/api/posts, require(./routes/posts)); // 统一错误处理必须放最后且四个参数不能少 app.use((err, req, res, next) { console.error(err.stack); res.status(err.status || 500).json({ code: 1, message: err.message }); }); mongoose.connect(process.env.MONGO_URI) .then(() app.listen(process.env.PORT || 3000, () console.log(server up))) .catch(err { console.error(mongo connect failed, err); process.exit(1); });逻辑说明express.json的limit默认 100kb博客提交富文本很容易超调到1mb是常见值再大要考虑分片上传。错误处理中间件必须放在所有路由之后且形参是四个少一个 Express 就不认它是错误处理器。mongoose.connect失败时直接process.exit(1)避免服务半死不活地挂着比让它静默重试更好排查。3.3 Mongoose 模型设计文章、分类、评论怎么关联MongoDB 是文档型但博客里文章和评论、文章和分类之间仍有引用关系。常见做法是文章存分类的 ObjectId 引用评论单独一个集合存文章 id// models/Post.js const mongoose require(mongoose); const postSchema new mongoose.Schema({ title: { type: String, required: true, trim: true, maxlength: 120 }, content: { type: String, required: true }, tags: [{ type: String, trim: true }], category: { type: mongoose.Schema.Types.ObjectId, ref: Category }, author: { type: mongoose.Schema.Types.ObjectId, ref: User, required: true }, status: { type: String, enum: [draft, published], default: draft }, views: { type: Number, default: 0 } }, { timestamps: true }); postSchema.index({ title: text, content: text }); // 全文索引 module.exports mongoose.model(Post, postSchema);逻辑说明ref声明引用关系查询时用.populate(category)把关联文档填进来。timestamps: true自动维护createdAt和updatedAt省得自己写。index建全文索引后可以用$text查询但注意一个集合只能有一个文本索引字段多了索引会变大写入也会变慢。enum限制状态值避免脏数据进库。4. 避坑与排查这套博客系统最容易翻车的五个地方4.1 连不上 MongoDB先看服务再看连接串现象启动报MongooseServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017。原因通常是 mongod 没起或者连接串端口写错。解决先mongosh确认能连再看.env里的MONGO_URI端口是否和 mongod 实际监听一致。如果 mongod 起了还连不上检查是不是绑定了bindIp: 127.0.0.1而你在用容器或远程地址访问。4.2 npm 脚本被拦PowerShell 执行策略的锅现象npm run dev报因为在此系统上禁止运行脚本。原因Windows PowerShell 默认执行策略是Restricted拦了npm.ps1。解决Set-ExecutionPolicy -Scope CurrentUser RemoteSigned或者改用 CMD 执行。别直接上Unrestricted那等于把脚本执行全放开。4.3 路由 404路径顺序和挂载前缀对不上现象访问/api/posts/archive返回 404 或进了详情接口。原因/:id定义在固定路径之前或者app.use挂载前缀和前端请求路径不一致。解决固定路径写在参数路径前面用req.originalUrl打日志确认实际进来的路径前端请求 baseURL 和app.use前缀对齐。4.4 提交大文章报 413body 体积超限现象发布长文返回PayloadTooLargeError或 413。原因express.json默认 limit 100kb。解决调大 limit但别无脑调到50mb按业务实际最大文章体积设同时前端做字数提示。如果文章带图片图片走单独上传接口别塞进 JSON。4.5 查询越来越慢缺索引和全表扫描现象文章列表页加载从几百毫秒涨到几秒。原因按createdAt排序但没建索引数据量上来后全集合扫描。解决给常用查询字段建索引postSchema.index({ createdAt: -1 })用explain(executionStats)看是否走了索引totalDocsExamined远大于返回条数就说明没走。5. 进阶用聚合管道做归档统计以及上线前该验证什么列表和详情跑通只是及格线博客系统真正体现 MongoDB 价值的地方是聚合统计。比如按年月归档文章数量用$group一步到位// 按年月统计已发布文章数 const stats await Post.aggregate([ { $match: { status: published } }, { $group: { _id: { year: { $year: $createdAt }, month: { $month: $createdAt } }, count: { $sum: 1 } }}, { $sort: { _id.year: -1, _id.month: -1 } } ]);逻辑说明$match先过滤能走索引放在管道最前面。$group的_id里用$year、$month从日期字段提取年月。$sort按年月倒序。参数上注意$match里的条件字段如果有索引聚合会快很多如果先$group再$match就没法用索引了。上线前我一般会验证三件事。第一是连接池Mongoose 默认 poolSize 是 100小站够用但要在压测下看serverStatus里的 connections 是否逼近上限。第二是错误日志把console.error换成带时间戳和请求 id 的结构化日志否则线上出问题只能靠猜。第三是数据备份mongodump定时跑别等删库了才想起后悔药# 备份 blog 库到指定目录 mongodump --urimongodb://127.0.0.1:27017/blog --out/backup/$(date %F)这套栈我踩过最深的坑不是代码是环境。同一份源码在别人机器上跑得飞起到自己这儿卡在 PowerShell 执行策略和 MongoDB 服务没注册上折腾一下午。后来我养成习惯拿到任何 Node 项目先node -v、npm -v、mongosh三连确认环境再动代码。希望帮到你。本文还有配套的精品资源点击获取