MongoClient连接异常：指定27018端口却连接到27017端口

针对你遇到的mongodb包5.5.0版本下，代码指定27018端口却实际连接27017的问题，给你几个排查和解决方向：

1. 检查环境变量干扰 #

驱动会优先读取环境变量中的连接配置，比如MONGODB_URI、MONGO_URI，如果这些变量被设置为mongodb://host:27017，会直接覆盖你代码里的连接字符串。可以运行以下命令排查：

# Linux/macOS
echo $MONGODB_URI
echo $MONGO_URI

# Windows（PowerShell）
echo $env:MONGODB_URI
echo $env:MONGO_URI

如果存在这类变量，直接删除或修改为目标端口即可。

2. 开启调试日志确认实际连接地址 #

在创建MongoClient时添加调试日志选项，查看驱动实际发起的连接详情，确认问题出在端口解析还是其他环节：

const {MongoClient} = require('mongodb');
const mongoClient = new MongoClient(`mongodb://host:27018`, {
  loggerLevel: 'debug'
});

// 执行连接并查看日志
async function connect() {
  try {
    await mongoClient.connect();
    console.log('Connected successfully');
  } catch (err) {
    console.error(err);
  }
}
connect();

运行后查看日志中的连接地址，就能明确是驱动解析问题还是代码其他部分的干扰。

3. 更换连接配置写法 #

尝试拆分host和port到配置选项中，避免连接字符串解析可能存在的bug：

// 写法1：拆分host和port
const mongoClient = new MongoClient('mongodb:///', {
  host: 'host',
  port: 27018
});

// 写法2：指定host后单独设置port
const mongoClient = new MongoClient('mongodb://host', {
  port: 27018
});

也可以直接使用服务器IP替代"host"，避免DNS解析可能带来的意外：

const mongoClient = new MongoClient(`mongodb://127.0.0.1:27018`);

4. 升级mongodb驱动版本 #

5.5.0版本可能存在端口解析的已知bug，建议升级到5.x系列的最新稳定版（比如5.9.1），修复版本缺陷：

npm install mongodb@^5.9.1

5. 验证代码唯一性 #

检查项目中是否存在其他创建MongoClient实例的代码，比如旧的配置文件、工具类，是否不小心复用了连接27017的实例，覆盖了当前配置。

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