Docker部署Mongodb_错误收集

Docker部署Mongodb_错误收集

WiredTiger 存储引擎无法正常访问数据文件

解决方案

1. 彻底清理残留数据文件

# 停止并删除旧容器
docker stop mongo && docker rm mongo

# 删除宿主机映射目录中的所有文件（谨慎操作！先备份重要数据）
sudo rm -rf /path/to/your/mongodb_data/*

# 重写创建文件夹
mkdir /path/to/your/mongodb_data

2. 确保目录权限正确（MacOS 特殊配置）

# 授予容器用户（UID 999）写权限（MacOS需通过 ACL 配置）
sudo chmod -R 777 /path/to/your/mongodb_data
sudo chown -R $(whoami) /path/to/your/mongodb_data

3. 调整 Docker 运行命令（关键参数优化）

docker run -d \
  --name mongo \
  -p 27017:27017 \
  -v /path/to/your/mongodb_data:/data/db \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=admin \
  --user 1000:50 \  # MacOS Docker 特殊 UID 配置
  --restart unless-stopped \
  mongo:latest \
  --wiredTigerCacheSizeGB 1  # 限制缓存大小适配小内存环境

4. 验证容器日志

docker logs -f mongo

预期看到：

{"t":{"$date":"2025-03-14T05:XX:XX.XXXZ"},"s":"I","c":"STORAGE","id":22430,"ctx":"initandlisten","msg":"WiredTiger message","attr":{"message":"WT_SESSION.create..."}}

---

关键配置解析

参数	作用说明
--user 1000:50	强制容器以 MacOS 当前用户（UID 1000）和 Docker 默认组（GID 50）运行
--wiredTigerCacheSizeGB 1	显式限制 WiredTiger 缓存为 1GB，避免内存不足导致崩溃
chmod 777	临时赋予完全权限（生产环境不推荐，开发环境可用）
rm -rf	清除可能存在的损坏文件或权限冲突文件

---

故障深度分析

错误日志解读

"msg":"__posix_open_file:924:/data/db/WiredTiger.wt: handle-open: open","error_str":"Operation not permitted"

表明 MongoDB 进程对 /data/db/WiredTiger.wt 文件 没有写权限 或 文件已被锁定。

MacOS 特殊限制

• Docker Desktop 使用虚拟机挂载文件系统（gRPC-FUSE），存在权限映射问题
• MacOS 原生文件系统（APFS）与 Linux 容器权限模型不兼容

---

高级方案（生产环境推荐）

使用 Docker Volume 代替直接挂载

# 创建 volume
docker volume create mongo_data

# 运行容器
docker run -d \
  -v mongo_data:/data/db \
  mongo:latest

查看 Volume 物理路径（MacOS）

docker volume inspect mongo_data

输出示例：

[
    {
        "CreatedAt": "2025-03-14T05:XX:XXZ",
        "Driver": "local",
        "Mountpoint": "/var/lib/docker/volumes/mongo_data/_data",
        "Name": "mongo_data",
        "Options": null,
        "Scope": "local"
    }
]

实际数据存储在 Docker 虚拟机中，避免直接操作宿主机文件系统。

---

总结

1. 开发环境：使用 chmod 777 快速修复权限，清理残留文件
2. 生产环境：
   • 使用 Docker Volume 避免路径映射问题
   • 通过 docker exec 进入容器检查文件权限
   • 定期备份 Volume 数据 (docker cp 或专用备份工具)

通过以上方案，可彻底解决因文件权限导致的 MongoDB 启动失败问题。