Aerospike NodeJS Client minConnsPerNode配置不生效问题求助

问题表现 #

• 使用Aerospike NodeJS客户端时，添加minConnsPerNode配置项后程序无法正常运行，删除该配置项后功能恢复正常
• 可复现问题的测试代码如下：

const Aerospike = require('aerospike')

const config = {
  hosts: '127.0.0.1:3000',
  minConnsPerNode: 1, // 删除该参数即可正常运行
}

const run = async () => {
  Aerospike.setDefaultLogging({ level: Aerospike.log.DEBUG, file: process.stderr.fd })
  const client = await Aerospike.connect(config);

  const puts = Array.from({ length: 5 }, (_, i) => client.put(new Aerospike.Key('ssd-store', 'test', i), { i }))

  await Promise.all(puts)
  client.close()
}

run()

根因说明 #

该问题通常由以下三类原因导致：

1. 客户端版本不兼容：minConnsPerNode 参数仅在 v3.12.0 及以上版本的 Aerospike NodeJS 客户端中稳定支持，低于该版本的客户端存在参数解析逻辑缺陷，会直接导致连接初始化失败
2. 参数边界配置错误：minConnsPerNode 的取值必须小于 maxConnsPerNode 配置的最大连接数，未显式配置最大连接数时默认值为100，若此前自定义过最大连接数小于设置的最小连接数，会触发参数校验失败
3. 预建连接超时：配置minConnsPerNode后，客户端初始化阶段会预先和每个节点建立对应数量的常驻连接，若此时服务端节点不可达、端口未开放或连接超时时间设置过短，会导致预建连接阶段直接抛出异常；未配置该参数时客户端为按需建立连接，初始化阶段不会触发连接校验，因此可以正常运行

修复方案 #

• 首先将Aerospike NodeJS客户端升级到v3.12.0及以上稳定版本
• 显式配置连接参数的边界值与超时时间，示例参考：

const config = {
  hosts: '127.0.0.1:3000',
  maxConnsPerNode: 100,
  minConnsPerNode: 1,
  connTimeoutMs: 5000 // 适当延长连接超时时间，避免预建连接阶段超时失败
}

• 若调整后仍无法正常运行，可通过DEBUG日志查看连接初始化阶段的具体错误信息，进一步排查是否存在服务端节点可达性问题

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