MongoDB文档创建指定时间后自动删除实现及报错排查

现有代码报错导致服务退出的核心原因有3个：

1. 响应重复发送：createLocation接口在文档保存成功后已经调用res.status(201).json(newLocation)把响应发回给客户端，HTTP连接已经关闭。30秒后setTimeout触发时你再次调用res.json()/res.status()往已经结束的响应写数据，会直接触发Cannot set headers after they are sent to the client未捕获错误，打崩Node进程。
2. 定时逻辑不可靠：基于内存setTimeout实现的定时删除完全没有容灾能力，只要服务重启、进程崩溃、内存回收，所有未触发的定时任务会直接丢失，过期文档会永久残留在数据库中。并发量高时大量定时器堆积还会占用过多内存拖垮服务。
3. 附带的隐性bug：
   • Schema里timeShared、dateShared的默认值是在模型文件加载时计算的，不是文档创建时计算，服务不重启的话所有新文档的默认时间都是服务启动的时间点，数据完全错误。
   • Mongoose连接配置传参错误，useFindAndModify被单独放在第三个参数里，Mongoose根本不会读取这个配置，会一直弹出弃用警告。
   • app.listen的回调里只写了字符串没加console.log，启动成功不会打印任何日志。

不要在业务代码里自己写定时删除逻辑，直接用MongoDB官方提供的TTL（生存时间）索引实现过期自动清理，这是MongoDB原生支持的功能，由数据库后台线程自动执行删除，不受服务重启影响，不需要写任何定时逻辑，稳定性远高于自定义代码。

具体修改步骤 #

1. 修正Schema定义，添加TTL索引，修复默认时间bug
   替换shareLocation.js的全部内容：

   import mongoose from "mongoose";
   
   const locationSchema = mongoose.Schema({
     // TTL索引字段，记录文档创建时间
     createdAt: {
       type: Date,
       default: Date.now,
       // 文档创建30秒后自动删除，按需修改这个值即可，比如1小时就填3600
       expires: 30
     },
     timeShared: {
       type: String,
       // 改为创建文档时动态生成时间
       default: () => {
         const now = new Date();
         const hours = now.getHours().toString().padStart(2, '0');
         const minutes = now.getMinutes().toString().padStart(2, '0');
         return `${hours}:${minutes}`;
       }
     },
     dateShared: {
       type: String,
       default: () => new Date().toDateString(),
     },
     latitude: {
       type: String,
       required: true,
     },
     longitude: {
       type: String,
       required: true,
     },
     city: {
       type: String,
     },
     road: {
       type: String,
     },
   });
   
   export default mongoose.model("shareLocation", locationSchema);
   

2. 清理控制器里的无效定时逻辑
   删除createLocation里所有setTimeout相关代码，修改后代码如下：

   export const createLocation = async (req, res) => {
     const { latitude, longitude, dateShared, timeShared, city, road } = req.body;
   
     const newLocation = new shareLocation({
       latitude,
       longitude,
       dateShared,
       timeShared,
       city,
       road,
     });
   
     try {
       await newLocation.save();
       res.status(201).json(newLocation);
     } catch (error) {
       res.status(409).json({ message: error.message });
     }
   };
   

3. 修正Mongoose连接配置
   修改server.js里的连接部分，把所有配置合并到同一个对象里，补全启动日志：

   mongoose
     .connect(
       "mongodb+srv://<creditentials>@cluster0.dqlf2.mongodb.net/locations?retryWrites=true&w=majority",
       { 
         useNewUrlParser: true, 
         useUnifiedTopology: true,
         useFindAndModify: false 
       }
     )
     .then(() => {
       app.listen(5000, () => {
         console.log("Server Running on port 5000");
       });
     })
     .catch((err) => {
       console.log(err);
     });
   

注意事项 #

• TTL索引的清理任务是MongoDB后台每60秒执行一次，所以删除时间会有最多1分钟的延迟，属于正常现象，绝大多数业务场景都可以接受。
• 如果需要给不同文档设置不同的过期时间，只需要不给索引设置固定expires值，在创建文档时给createdAt字段赋值为需要删除的具体时间点即可，MongoDB会在到达该时间后自动删除对应文档。
• 第一次添加TTL索引时，如果集合里已有历史数据，MongoDB会自动在后台构建索引，不需要手动处理。

内容的提问来源于stack exchange，提问作者MoonSungKil