1. 项目概述半亩菜园线上预售系统是一个基于Node.js的农产品电商平台旨在连接城市消费者与郊区农场实现新鲜农产品的在线预订和配送。这个毕设项目采用了现代化的全栈技术架构包含完整的前后端实现、数据库设计以及部署方案。我在实际开发过程中发现这类农产品预售系统有几个关键痛点需要解决农产品库存的时效性管理配送时间的精准预估用户信任体系的建立农场主后台的简易操作2. 系统架构设计2.1 技术栈选型后端技术栈Node.js Express轻量高效的JavaScript运行时MongoDB文档型数据库适合存储非结构化的农产品数据Redis缓存用户会话和热门商品数据前端技术栈Vue 3 Vite现代化的前端开发体验Element Plus提供丰富的UI组件Axios处理HTTP请求技术选型心得相比传统的Java技术栈Node.js在开发效率上有明显优势特别适合需要快速迭代的电商类项目。MongoDB的灵活schema设计也让农产品这类属性多变的数据模型更容易处理。2.2 系统架构图系统采用典型的三层架构[客户端] ←HTTP→ [Node.js服务层] ←数据库驱动→ [MongoDB] ↑ [Redis缓存]这种架构的优势在于前后端完全分离便于独立部署和扩展无状态的服务层可以方便地水平扩展缓存层显著减轻数据库压力3. 核心功能实现3.1 用户认证模块采用JWT(JSON Web Token)实现无状态认证关键代码如下// 生成Token const generateToken (user) { return jwt.sign( { userId: user._id, role: user.role }, process.env.JWT_SECRET, { expiresIn: 7d } ); }; // 认证中间件 const auth async (req, res, next) { try { const token req.header(Authorization).replace(Bearer , ); const decoded jwt.verify(token, process.env.JWT_SECRET); req.user await User.findById(decoded.userId); next(); } catch (e) { res.status(401).send({ error: 请先登录 }); } };安全提示务必设置合理的token过期时间生产环境建议不超过24小时。我在测试时发现过长的token有效期会增加安全风险。3.2 农产品预售功能核心数据结构设计const productSchema new mongoose.Schema({ name: { type: String, required: true }, farm: { type: mongoose.Schema.Types.ObjectId, ref: Farm }, category: { type: String, enum: [蔬菜, 水果, 禽蛋, 其他] }, price: { type: Number, min: 0, required: true }, unit: { type: String, default: 斤 }, harvestDate: { type: Date }, // 预计采收日期 deliveryDate: { type: Date }, // 预计配送日期 stock: { type: Number, min: 0 }, images: [String], description: String, isFeatured: { type: Boolean, default: false } }, { timestamps: true });预售业务流程农场主发布农产品信息用户浏览并下单预订系统生成预订单农产品成熟后安排配送用户确认收货3.3 订单处理流程订单状态机设计待支付 → 已支付 → 备货中 → 已发货 → 已完成 ↓ ↓ 取消订单 退款/售后关键实现代码router.post(/orders, auth, async (req, res) { try { const order new Order({ ...req.body, user: req.user._id, status: pending }); // 库存预扣减 for (const item of order.items) { await Product.updateOne( { _id: item.product }, { $inc: { stock: -item.quantity } } ); } await order.save(); res.status(201).send(order); } catch (e) { res.status(400).send({ error: e.message }); } });4. 数据库设计4.1 主要集合关系图用户(User) → 订单(Order) ← 产品(Product) ← 农场(Farm)4.2 索引优化实践为提高查询性能我为以下字段创建了索引// 用户集合 userSchema.index({ email: 1 }, { unique: true }); // 产品集合 productSchema.index({ name: text, description: text }); productSchema.index({ category: 1, price: 1 }); productSchema.index({ farm: 1 }); // 订单集合 orderSchema.index({ user: 1 }); orderSchema.index({ createdAt: -1 });性能提示文本索引虽然强大但会显著增加存储空间。对于小型电商系统可以考虑使用第三方搜索服务如Elasticsearch。5. 部署方案5.1 生产环境部署推荐使用PM2管理Node.js进程# 安装PM2 npm install pm2 -g # 启动应用 pm2 start server.js --name farm-market # 设置开机自启 pm2 startup pm2 save5.2 Nginx配置示例server { listen 80; server_name yourdomain.com; location / { proxy_pass http://localhost:3000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; proxy_set_header Host $host; proxy_cache_bypass $http_upgrade; } location /static/ { alias /path/to/your/static/files/; expires 30d; } }6. 项目亮点与创新动态库存管理实现了基于预售模式的库存计算算法避免超卖农产品溯源每个产品页面展示农场信息和生长过程图片预约配送系统用户可以选择方便的收货时间段农场主APP配套开发了简易的农场管理移动端界面7. 常见问题排查7.1 性能问题问题首页加载缓慢特别是产品列表部分解决方案实现分页查询默认只加载第一页数据使用Redis缓存热门产品数据对产品图片进行压缩和CDN加速7.2 支付集成问题支付回调处理不及时解决方案使用Webhook处理支付通知设置订单状态检查定时任务实现本地支付日志用于对账7.3 跨域问题问题开发环境频繁出现CORS错误解决方案// Express中间件配置 app.use(cors({ origin: process.env.NODE_ENV development ? [http://localhost:8080] : [https://yourdomain.com], credentials: true }));8. 项目扩展方向会员订阅系统定期配送新鲜农产品社区团购功能基于地理位置的集体采购农产品检测报告上传第三方检测结果农场直播功能实时展示农产品生长情况在实际开发中我特别建议重视日志系统的建设。使用winston等日志库记录关键操作这对后期排查问题非常有帮助。例如const logger winston.createLogger({ level: info, format: winston.format.json(), transports: [ new winston.transports.File({ filename: error.log, level: error }), new winston.transports.File({ filename: combined.log }) ] }); if (process.env.NODE_ENV ! production) { logger.add(new winston.transports.Console({ format: winston.format.simple() })); }这个项目从技术选型到最终部署完整展示了如何使用Node.js开发现代化的电商系统。对于计算机专业的学生来说理解全栈开发的各个环节非常重要这也是我在辅导学生时特别强调的实践能力。