PG 8.10.0在Node.js v19.8.1下无法运行，需如何修复？

问题分析 #

你遇到的ERR_INVALID_ARG_TYPE报错，根源是pg-protocol在序列化启动参数时，收到了对象类型的参数而非预期的字符串/Buffer，这通常是连接配置格式错误或pg版本与Node.js 19兼容性问题导致的。降级到8.2.2本地生效但生产环境无效，大概率是生产环境依赖缓存、配置不一致或版本未正确更新导致。

具体修复步骤 #

1. 排查并修正PostgreSQL连接配置 #

• 检查你的pg连接配置对象/字符串，确保所有必填字段（user、password、database、host等）均为字符串类型，不存在对象或未解析的环境变量。
• 示例：避免出现类似{ password: process.env.DB_PASSWORD }但环境变量未正确加载导致变成undefined或对象的情况。
• 临时调试：在创建pg客户端前打印配置，排查异常字段：

  const pgConfig = { /* 你的配置 */ };
  console.log('PG连接配置:', JSON.stringify(pgConfig));
  

2. 升级pg到兼容Node.js 19的版本 #

pg 8.10.0存在与Node.js 19的兼容性问题，建议升级到8.11.x及以上版本（官方已修复相关适配问题），避免使用过旧的8.2.2版本（存在安全和功能缺陷）：

npm install pg@latest
# 或指定稳定版本
npm install pg@8.11.3

3. 清理生产环境依赖缓存 #

生产环境可能残留旧依赖文件，导致版本不生效：

• Linux/macOS：

  rm -rf node_modules package-lock.json
  npm install
  

• Windows（命令提示符）：

  rd /s /q node_modules
  del package-lock.json
  npm install
  

• 若使用Yarn：

  yarn cache clean
  rm -rf node_modules yarn.lock
  yarn install
  

4. 确保生产环境Node.js版本与本地一致 #

验证生产环境Node.js版本：

node -v

若版本与本地的v19.8.1不一致，调整生产环境Node.js版本（可通过nvm等版本管理工具切换）。

5. 避免手动修改pg-protocol版本 #

报错来自pg-protocol，该包是pg的依赖，升级pg时会自动同步兼容版本，不要单独修改其版本号，避免依赖冲突。

原始报错信息 #

TypeError [ERR_INVALID_ARG_TYPE]: The "string" argument must be of type string or an instance of Buffer or ArrayBuffer. Received an instance of Object
    at new NodeError (node:internal/errors:387:5)
    at Function.byteLength (node:buffer:740:11)
    at Writer.addCString (C:\Users\anisha\tradephlo\admin-backend\node_modules\pg-protocol\dist\buffer-writer.js:42:30)
    at Object.startup (C:\Users\anisha\tradephlo\admin-backend\node_modules\pg-protocol\dist\serializer.js:10:32)
    at Connection.startup (C:\Users\anisha\tradephlo\admin-backend\node_modules\pg\lib\connection.js:128:33)
    at Connection.<anonymous> (C:\Users\anisha\tradephlo\admin-backend\node_modules\pg\lib\client.js:120:13)
    at Connection.emit (node:events:513:28)
    at Socket.<anonymous> (C:\Users\anisha\tradephlo\admin-backend\node_modules\pg\lib\connection.js:49:12)
    at Object.onceWrapper (node:events:627:28)
    at Socket.emit (node:events:525:35) {
  code: 'ERR_INVALID_ARG_TYPE'
}
[nodemon] app crashed - waiting for file changes before starting..

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