Laravel连接MongoDB Atlas出现TLS证书验证失败如何解决？

问题原因 #

该报错是Heroku运行环境下PHP MongoDB扩展无法正常验证MongoDB Atlas的TLS证书导致的，本地运行正常是因为本地操作系统内置了完整的根证书信任库，而Heroku环境需要显式指定CA证书路径适配。

解决步骤 #

• 第一步：修改config/database.php中的MongoDB配置，补充TLS相关参数，指定Heroku系统内置的CA证书路径：

'mongodb' => [
    'driver' => 'mongodb',
    'dsn' => env('DB_URI', 'mongodb+srv://username:password@cluster0.mhfxu.mongodb.net/database?retryWrites=true&w=majority'),
    'database' => env('DB_DATABASE'),
    'options' => [
        'tls' => true,
        'tlsCAFile' => '/etc/ssl/certs/ca-certificates.crt',
    ],
],

• 第二步：确认composer.json的require段已声明MongoDB扩展依赖，保证Heroku部署时自动启用对应扩展：

{
  "require": {
    "ext-mongodb": "*",
    "jenssegers/mongodb": "^3.9"
    // 其余依赖保持不变
  }
}

• 第三步：检查Heroku环境变量配置，确认DB_URI和DB_DATABASE两个参数已正确配置到Heroku后台的Config Vars中，不要使用配置文件里的硬编码默认值。
• 第四步：可选调试方案：如果临时排查问题，可以在DB_URI末尾追加参数&tlsAllowInvalidCertificates=true跳过证书验证，注意该配置存在安全风险，生产环境禁止使用。
• 第五步：配置修改后重新部署Heroku项目，部署完成后可以执行heroku run php artisan tinker，运行MongoDB::connection()->getMongoClient()测试连接是否正常。

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