GCP同实例部署的Node.js应用连接MongoDB出现认证失败问题

• 第一步：验证连接字符串正确性
  你可以在Node.js连接代码的uri拼接完成后，新增一行console.log(uri)，将打印的连接字符串和本地正常运行的Node.js应用的连接字符串做逐字对比，确认是否完全一致。
  重点检查：GCP实例上加载的环境变量是否正确，尤其是密码包含@、:、/等特殊字符时，是否存在环境变量导出时被shell转义、.env文件配置错误的情况。另外注意你提供的代码示例中uri拼接使用了&作为参数分隔符，这是HTML转义后的内容，正常Node.js代码中应该直接使用&，如果实际代码中确实写的是&会导致参数解析错误，直接引发认证失败。
• 第二步：查看MongoDB服务端日志定位错误原因
  登录GCP的Ubuntu实例，查看MongoDB日志文件（默认路径为/var/log/mongodb/mongod.log），找到对应时间点的AuthenticationFailed错误日志，日志中会明确标注认证失败的具体原因：是用户名不存在、authSource配置错误、认证机制不匹配还是密码错误。
• 第三步：修改连接地址测试
  本地访问时你使用的应该是GCP实例的公网IP，同机部署时可以尝试将MONGO_DB_ADDRESS改为127.0.0.1或者内网IP，避免公网IP回环访问时被GCP VPC防火墙或实例内部iptables规则拦截导致的异常。
• 第四步：验证依赖安装完整性
  先删除GCP实例上项目的node_modules文件夹和package-lock.json文件，重新执行npm install安装依赖，避免驱动文件损坏导致的异常。之后可以写一个极简测试脚本，硬编码用户名、密码、地址等配置，绕过环境变量加载逻辑直接连接，如果测试脚本可以正常连接，说明问题出在环境变量加载环节。
• 第五步：核对用户认证配置
  登录MongoDB CLI，执行use 你的authSource库，再执行db.getUser("你的用户名", {showCredentials: true})，查看用户支持的认证机制是否和代码中配置的authMechanism一致，同时确认authSource参数是否对应用户创建时所在的库。

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