authSource必须显式指定以避免认证失败，tls=true为强制要求确保加密连接，生产环境需合理配置连接池并URL编码密码。

连接字符串必须包含 authSource 和 tls 参数

不加 authSource 会导致认证失败，哪怕用户名密码正确；不显式启用 tls（或 ssl）则无法建立加密通道，连接会直接被拒绝。

• authSource 通常设为 admin，除非你把用户建在其他数据库里（比如 myapp），那就得对应改成 myapp
• tls=true 是强制要求，MongoDB Atlas 默认只允许 TLS 连接；本地自建带 TLS 的集群也一样
• 若用自签名证书，需额外加 tlsCAFile=/path/to/ca.pem，否则 Node.js 会报 MongoServerSelectionError: unable to verify the first certificate

MongoClient.connect() 的 options 里别漏掉 minPoolSize 和 maxPoolSize

默认连接池大小（minPoolSize=0, maxPoolSize=100）在高并发场景下容易成为瓶颈，尤其配合 TLS 握手时延迟明显升高。

logos-node

在 Linux x86_64 上安装、更新或检查 Logos 区块链测试网验证节点。用于用户需要搭建 Logos 节点时使用。

下载

• 生产环境建议设 minPoolSize: 5 + maxPoolSize: 20，避免冷启动抖动
• 如果应用是短生命周期（如 Serverless），反而要设 minPoolSize: 0 并手动调用 client.close()，否则连接泄漏
• 别在每次请求都新建 MongoClient 实例——这是最常见内存和连接数暴涨的根源

使用 mongosh 验证连接参数前，先检查 Node.js 版本是否支持 TLS 1.2+

Node.js v12.22.0 之前版本默认禁用 TLS 1.3，而部分云 MongoDB（如 Atlas 的新集群）已停用 TLS 1.2，导致 connect ECONNREFUSED 或静默超时。

• 运行 node -v，确认 ≥ v14.0.0（推荐 ≥ v18.17.0）
• 验证命令：mongosh "mongodb+srv://user:pass@cluster.xzy12.mongodb.net/?tls=true&authSource=admin"
• 如果 mongosh 能连通但 Node.js 不行，大概率是 Node.js TLS 配置或 DNS 解析问题，不是 MongoDB 设置问题

凭证不要硬编码，MONGODB_URI 环境变量必须 URL 编码特殊字符

密码含 +、/、@、: 时，未编码会导致解析错误，现象是 Authentication failed 或 Invalid hostname。

• 用 encodeURIComponent() 处理密码（仅密码，不是整个 URI）：例如密码 pa@ss/w+rd → pa%40ss%2Fw%2Brd
• 推荐构造方式：mongodb+srv://user:${encodeURIComponent(password)}@cluster...
• 本地开发可用 .env，但上线必须通过系统环境变量注入，避免泄露到构建产物中

TLS 握手、连接池复用、URI 编码这三处最容易出错，而且错误表现往往不直接指向根源——比如认证失败，实际可能是 TLS 握手卡住后触发了超时降级，最后报的是凭据错误。