如何在GitHub上安全存储MongoDB连接串并保证项目可测试？

1. 提供.env示例文件 #

• 在项目根目录创建.env.example文件，写入变量名和占位符模板：

  MONGO_LINK=mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]
  

• 将.env.example提交到GitHub，保持.env在.gitignore中。
• 克隆项目的人员可复制.env.example并重命名为.env，替换为自己的MongoDB连接信息（评审人员可用自身测试数据库，或你提供只读测试账号）。

2. 环境变量注入启动 #

• 在App.js中优先读取系统环境变量，无对应变量时再加载dotenv配置：

  require('dotenv').config();
  const mongoLink = process.env.MONGO_LINK || 'mongodb://localhost:27017/default-test-db';
  

• 评审人员启动项目前可直接设置临时环境变量：
  • Linux/macOS终端：

    export MONGO_LINK="mongodb://test-account:test-pass@host:port/test-db" && node app.js
    

  • Windows PowerShell：

    $env:MONGO_LINK="mongodb://test-account:test-pass@host:port/test-db"; node app.js
    

3. 配置本地测试默认连接 #

• 在代码中添加本地MongoDB实例的无认证连接作为 fallback，当环境变量未配置时自动启用：

  const mongoLink = process.env.MONGO_LINK || 'mongodb://localhost:27017/local-test-db';
  

• 克隆项目的人员只需本地安装并启动MongoDB服务，即可直接运行项目测试基础功能，无需额外配置。

4. 提供只读测试账号（可选） #

• 创建一个仅拥有只读权限的MongoDB账号，将对应的连接串写在项目README中，或放在.env.example的注释里：

  # 测试用只读账号连接串（仅用于功能验证）
  # MONGO_LINK=mongodb://readonly-user:readonly-pass@your-host:port/test-db?readPreference=primary
  

• 该账号无法修改数据，既保障生产数据安全，又能让评审人员直接测试完整功能。

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