最新版Laravel连接MongoDB数据库出现连接未配置报错如何解决？

报错信息：InvalidArgumentException: Database connection [Users] not configured

这个错误本质是Laravel读取数据库配置时，无法找到代码中指定的名为Users的连接项，和MongoDB服务本身的运行状态无关，按以下步骤排查即可：

1. 核对config/database.php的连接定义 #

打开项目根目录下的config/database.php，检查connections数组中是否存在键名为Users的MongoDB连接配置，标准配置参考如下：

'connections' => [
    // 原有其他数据库连接保留
    'Users' => [
        'driver'   => 'mongodb',
        'host'     => env('MONGO_HOST', '127.0.0.1'),
        'port'     => env('MONGO_PORT', 27017),
        'database' => env('MONGO_DATABASE', 'default_db'),
        'username' => env('MONGO_USERNAME', ''),
        'password' => env('MONGO_PASSWORD', ''),
        'options'  => [
            'database' => 'admin' // 认证用默认数据库，按需调整
        ]
    ],
]

注意：Laravel配置键是大小写敏感的，键名必须和你代码中调用的连接名完全一致，拼写、大小写有任何差异都会触发报错

2. 核对业务代码的连接调用写法 #

检查你操作MongoDB时指定连接的代码：

• 用DB门面调用时，写法为DB::connection('Users')，括号内的字符串必须和配置键名完全匹配
• 在Eloquent模型中指定连接时，属性定义为protected $connection = 'Users';，同样要核对拼写与大小写

3. 刷新配置缓存 #

修改配置后执行以下命令清除旧的配置缓存：
php artisan config:clear
如果是生产环境，清除后可重建缓存：
php artisan config:cache

4. 兜底排查项 #

如果上述步骤完成后仍报错，检查两项依赖：

• 确认已安装和当前Laravel版本兼容的MongoDB拓展包jenssegers/mongodb
• 确认PHP已安装mongodb扩展，可执行php -m在扩展列表中核对

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