初始化用户失败主因是权限、时机或认证开关不匹配：官方镜像仅在/data/db为空时执行/docker-entrypoint-initdb.d/脚本；--auth开启后需显式认证才能createuser；bindip配置不当或localhost免密机制失效（6.0+默认关闭）也会导致失败。
初始化用户失败，90% 是权限、时机或认证开关没对上，不是脚本写错了。
mongo-initdb 脚本不执行？检查 volumes 和启动顺序
官方 mongo 镜像只在容器首次启动、且 /data/db 为空时，才执行 /docker-entrypoint-initdb.d/ 下的 .js 或 .sh 文件。常见失效场景：
- 宿主机挂载的
/data/db目录非空（比如之前跑过、残留 journal 或 WiredTiger 文件）→ 镜像跳过初始化 - 挂载路径写错，例如
volumes: - ./mongo_data:/data/db但./mongo_data实际不存在 → 容器用默认 tmpfs，初始化后数据全丢 - 用了
depends_on却没配healthcheck→mongo容器已 up，但 WiredTiger 还在 recover，init 脚本连不上localhost:27017，静默失败
验证方式：docker exec -it mongo_container ls /data/db 看是否为空；再 docker logs mongo_container 搜索 Initializing database 或 running /docker-entrypoint-initdb.d/。
createUser 报错 “command requires authentication”？先确认 --auth 是否开启
如果 docker-compose.yml 里加了 --auth（或环境变量 MONGO_INITDB_ROOT_USERNAME），init 脚本必须显式连接带凭据的 admin 库，否则 db.createUser() 直接被拒绝：
- 错误写法（无认证连接）：
mongosh --eval "db.createUser(...)" - 正确写法（带 root 凭据）：
mongosh -u root -p user123 --authenticationDatabase admin --eval "db.createUser({user:'app', pwd:'pass', roles:['readWrite']})" - 注意：
MONGO_INITDB_ROOT_USERNAME和MONGO_INITDB_ROOT_PASSWORD只用于创建 root 用户，不自动让后续命令免密
更稳妥的做法：init 脚本开头先 use admin，再 db.auth("root", "user123")，之后所有操作才有效。
Windows 或 macOS 上 init 脚本乱码或不识别？统一用 LF 换行 + UTF-8 编码
Windows 默认 CRLF 换行、macOS 旧版可能用 CR，mongosh 解析 .js 文件时会卡在第一行报语法错误（如 Unexpected token ILLEGAL）：
- 用 VS Code 或 Notepad++ 打开脚本 → 右下角切换换行符为
LF→ 编码选UTF-8（不要带 BOM） - 命令行快速修复：
sed -i 's/\r$//' init_user.js（Linux/macOS）；Windows 可用dos2unix init_user.js - 避免在脚本里写中文注释或路径——某些镜像内嵌的
mongosh对非 ASCII 处理不稳定
验证是否生效：docker exec mongo_container cat /docker-entrypoint-initdb.d/init_user.js | head -n 3，确认输出无 ^M 符号。
init 成功但用户无法登录？检查 bindIp 和网络模式
用户创建成功，但外部客户端连不上，大概率是服务监听范围不对：
- 默认
mongod只绑127.0.0.1，容器内能连，宿主机或其它容器连不上 → 加--bind_ip_all或--bind_ip 0.0.0.0 - 用
bridge网络时，其他容器必须通过服务名（如mongo:27017）访问，不能用localhost；若用host网络，则直接用宿主机 IP -
docker-compose 中若定义了
network_mode: host，但又写了ports字段 → 冲突，ports会被忽略
快速诊断：docker exec mongo_container mongosh --eval "db.runCommand({getCmdLineOpts: 1})"，查 parsed.net.bindIp 值；再 docker exec mongo_container ss -tln | grep 27017 确认监听地址是 *:27017 而非 127.0.0.1:27017。
最易被忽略的一点：MongoDB 6.0+ 默认启用 enableLocalhostAuthBypass: false，意味着即使你没开 --auth，root 用户也必须走认证流程才能执行管理命令——别再依赖“本地免密”老习惯。
