容器化Express.js应用指定数据库名时无法连接MongoDB容器问题

问题根因 #

你本地部署的MongoDB实例中，root用户是创建在admin认证库下的，当你在连接串中指定自定义数据库名时，MongoDB会默认使用你指定的数据库作为认证源，去该库下查找用户凭据，自然找不到你创建在admin库的root用户，导致认证失败。
而你生产用的MongoDB Atlas连接串默认自带了正确的authSource配置，且Atlas的用户认证逻辑默认绑定全局权限，因此不会出现该问题。
另外你看到启动日志正常，是因为Mongoose的连接初始化是异步懒加载的，只有第一次实际执行数据库操作（也就是API请求触发读写时）才会执行真实的认证流程，认证失败后请求没有正确捕获异常返回，就会出现浏览器提示无响应的问题。

解决方法 #

有两种常用方案可选：

方案1：修改本地MongoDB连接串，指定认证源 #

在你本地的连接串末尾增加authSource=admin参数即可，修改后的连接串为：
mongodb://root:root@db:27017/MyApp?authSource=admin
该参数会告知MongoDB使用admin库作为用户认证源，认证通过后再操作MyApp库，符合你本地MongoDB的用户配置。

方案2：在Mongoose连接配置中指定库名（多环境适配更友好） #

如果你不想拆分不同环境的连接串规则，可以直接在连接代码中通过参数指定库名，适配本地和生产环境：

import mongoose from 'mongoose';

export const connectMongoDb = async () => {
    try {
        return await mongoose.connect(process.env.MONGODB_URL as string, {
          // 固定指定业务库名，优先级高于连接串中的库名配置
          dbName: process.env.MONGODB_DB_NAME || 'MyApp',
          // 本地环境指定认证源，生产Atlas环境会自动忽略不兼容的authSource配置
          authSource: process.env.NODE_ENV === 'development' ? 'admin' : undefined
        });
    } catch (err) {
        // 建议增加错误日志打印，方便后续定位问题
        console.error('MongoDB连接失败:', err);
        return process.exit(1);
    }
};

这个方案的好处是后续如果要修改业务库名，只需要改一处配置即可，不用调整各环境的连接串，同时兼容本地和生产的认证逻辑。

验证 #

修改配置后重启服务，首次写入projects集合时MongoDB会自动创建MyApp库，不会再默认写入test库。

内容的提问来源于stack exchange，提问作者João Casarin