AWS Fargate无法正常停止MongoDB容器致重启失败的解决方法

出现这个错误的核心原因是Fargate停止任务时，MongoDB进程未收到优雅终止信号（SIGTERM），或没有足够时间完成关闭流程，导致/data/db/mongod.lock锁文件残留。新任务实例启动时，MongoDB检测到锁文件存在，误以为已有进程在运行，从而启动失败。以下是具体解决配置方案：

1. 调整任务定义的停止超时时间 #

Fargate默认任务停止超时为30秒，对MongoDB来说可能不足以完成优雅关闭（尤其是有大量数据需要刷盘时）。在任务定义的容器配置中增加stopTimeout参数，延长等待时间：

"containerDefinitions": [
  {
    "name": "mongo-container",
    "image": "public.ecr.aws/docker/library/mongo:6.0",
    "stopTimeout": 60,
    // 其他容器配置...
  }
]

该配置会让Fargate先向MongoDB进程发送SIGTERM信号，等待60秒后若进程仍未终止，再发送SIGKILL强制终止。

2. 确保MongoDB能接收并处理SIGTERM信号 #

官方MongoDB镜像已支持优雅处理SIGTERM，但如果自定义了CMD或ENTRYPOINT，需使用exec格式命令，避免shell进程拦截信号：

• 错误示例（shell格式，信号会被shell接收，无法传递给mongod）：

  "command": ["mongod --bind_ip_all"]
  

• 正确示例（exec格式，信号直接传递给mongod进程）：

  "command": ["mongod", "--bind_ip_all"]
  

3. 自定义启动脚本清理残留锁文件 #

若上述配置仍无法避免锁文件残留，可通过自定义启动脚本，在MongoDB启动前检查并清理锁文件（仅适用于Fargate任务独占存储的场景，如使用临时存储或每个任务对应独立EFS目录）：

1. 创建启动脚本start-mongo.sh：

   #!/bin/sh
   # 检查并删除残留锁文件
   if [ -f /data/db/mongod.lock ]; then
       rm -f /data/db/mongod.lock
   fi
   # 以exec方式启动MongoDB，确保信号能传递
   exec mongod "$@"
   

2. 基于官方镜像构建自定义镜像：

   FROM public.ecr.aws/docker/library/mongo:6.0
   COPY start-mongo.sh /usr/local/bin/
   RUN chmod +x /usr/local/bin/start-mongo.sh
   ENTRYPOINT ["start-mongo.sh"]
   

3. 将自定义镜像推送到ECR，在Fargate任务定义中使用该镜像。

4. 避免共享存储的冲突场景 #

若MongoDB使用EFS等持久化共享存储，需确保每个Fargate任务实例使用独立存储目录，而非共享同一个/data/db：

"mountPoints": [
  {
    "sourceVolume": "mongo-efs",
    "containerPath": "/data/db",
    "readOnly": false
  }
],
"volumes": [
  {
    "name": "mongo-efs",
    "efsVolumeConfiguration": {
      "fileSystemId": "fs-xxxxxx",
      "rootDirectory": "/mongo-instances/${AWS_TASK_ID}"
    }
  }
]

通过${AWS_TASK_ID}为每个任务分配唯一子目录，彻底避免锁文件冲突。

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