Strapi连接MongoDB Atlas报错无法启动服务该如何解决？

所有报错的核心原因是Strapi的Mongoose连接器会自动拼接MongoDB连接URI，配置时将mongodb+srv://前缀、数据库名、查询参数错误填写到了host字段中，导致最终生成的连接URI格式非法：

• 未开启SRV模式时，连接器会按照普通MongoDB协议拼接地址，无法识别Atlas的SRV域名
• 把mongodb+srv://前缀写到host字段时，连接器会尝试解析mongodb+srv作为域名，无法找到对应地址
• 开启SRV模式但host字段携带了数据库路径、查询参数时，URI校验失败，提示缺少合法域名

提供两种可行的配置方式，二选一即可：

方案1：拆分参数配置（SRV模式，推荐） #

修改数据库配置文件 #

connections: {
  default: {
    connector: 'mongoose',
    settings: {
      host: env('DB_MONGO_HOST', '127.0.0.1'),
      srv: env.bool('DATABASE_SRV', false),
      port: env.int('DB_PORT', 27017),
      database: env('DATABASE_NAME', 'mydb'),
      username: env('DB_USER_NAME', null),
      password: env('DB_PASSWORD', null)
    },
    options: {
      authenticationDatabase: env('AUTHENTICATION_DATABASE', 'admin'),
      ssl: env.bool('DB_SSL_ENABLE', true),
      queryParameters: {
        ssl_cert_reqs: 'CERT_NONE'
      }
    },
  }
}

修改.env参数 #

# host仅填写纯域名，不要加前缀、路径、查询参数
DB_MONGO_HOST=myproject.random.mongodb.net
DATABASE_SRV=true
DATABASE_NAME=mydbt
DB_USER_NAME=myuser
# 注意检查密码拼写，历史配置中曾少写最后一位d
DB_PASSWORD=mypassword
DB_SSL_ENABLE=true
AUTHENTICATION_DATABASE=admin

方案2：直接使用完整连接URI（更简单，避免拼接错误） #

直接传入完整的MongoDB连接串，不需要拆分各字段，和MongoDB Compass中使用的连接串完全一致即可。

修改数据库配置文件 #

connections: {
  default: {
    connector: 'mongoose',
    settings: {
      uri: env('DATABASE_URI'),
    },
    options: {}
  }
}

修改.env参数 #

# 直接填写带用户名、密码、数据库名、参数的完整连接串
DATABASE_URI=mongodb+srv://myuser:mypassword@myproject.random.mongodb.net/mydbt?ssl_cert_reqs=CERT_NONE

• 确认MongoDB Atlas账号密码拼写正确，权限配置正常
• 拆分参数配置时，绝对不要把协议前缀、数据库名、查询参数填写到host字段
• MongoDB Atlas默认要求SSL连接，不要关闭SSL配置

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