Google Cloud Spanner Node.js库参数化SQL使用报错排查

问题根源 #

你遇到的问题是因为PostgreSQL方言的Spanner参数化语法和Spanner默认规则不兼容，既不是代码写法错误，也不是数据库配置问题，只是参数格式和传递方式没匹配PostgreSQL的要求。

正确的参数化写法 #

针对PostgreSQL方言，Spanner Node.js库的参数化查询必须遵循PostgreSQL原生占位符规则：

• 使用$1、$2这类位置占位符，而非@Name或@p1格式
• 参数值按占位符的位置顺序传入，无需指定参数名

示例代码 #

// PostgreSQL方言下的正确参数化查询
const [rows] = await database.run(
  'SELECT * FROM users WHERE name = $1 AND age > $2',
  ['Alice', 30]
);

之前写法报错的原因 #

1. 使用@Name时报错：Spanner默认的@p1命名参数格式仅适用于Google标准SQL方言，PostgreSQL方言不支持这种写法，因此会要求你改用p1、p2格式，但这本身就不符合PostgreSQL规则
2. 改用@p1时报错“列p1不存在”：PostgreSQL方言会把@p1解析为列名，而非参数占位符，数据库自然找不到名为p1的列

额外提示 #

如果参数较多，想通过命名参数提升代码可读性，可以自己做一层映射，把命名参数转换成位置占位符后再执行查询。同时可以在Google Cloud控制台的Spanner实例详情页，确认数据库确实配置为PostgreSQL方言。

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