Node.js向PostgreSQL插入数据异常：参数未正确替换求助

问题原因 #

你用'||$1||'这种写法完全搞错了pg库参数化查询的逻辑：

• pg的参数占位符$1、$2是直接作为SQL语句的一部分使用的，不需要用字符串拼接符号||包裹
• 用'||$1||'会让PostgreSQL把$1当成普通字符串文本，直接插入到表中，而不是解析成你传入的变量值
• 这种写法还会引入SQL注入风险，完全违背了参数化查询的安全设计

修复方法 #

1. 移除占位符周围的||和多余引号：直接把$n作为值的占位符放在SQL语句里
2. 保证参数顺序对应：调用client.query()时，第二个参数的数组元素顺序要和$1、$2的顺序完全匹配
3. 如果需要字符串拼接：把固定字符串和占位符用||连接，比如'前缀' || $1 || '后缀'，而不是把占位符整个包起来

错误代码 vs 修复后代码 #

错误示例（导致插入占位符文本） #

const { Client } = require('pg');

const client = new Client({
  connectionString: '你的数据库连接字符串'
});

async function insertData() {
  await client.connect();
  const username = 'test_user';
  // 错误：用||包裹了占位符，导致插入"$1"字符串
  const queryText = "INSERT INTO myTable (username) VALUES ('||$1||')";
  const res = await client.query(queryText, [username]);
  console.log('插入结果:', res);
  await client.end();
}

insertData();

正确示例（插入实际值） #

const { Client } = require('pg');

const client = new Client({
  connectionString: '你的数据库连接字符串'
});

async function insertData() {
  await client.connect();
  const username = 'test_user';
  // 正确：直接使用$1作为占位符
  const queryText = "INSERT INTO myTable (username) VALUES ($1)";
  const res = await client.query(queryText, [username]);
  console.log('插入成功，影响行数:', res.rowCount);
  await client.end();
}

insertData();

字符串拼接场景示例 #

如果需要给插入的值添加固定前缀/后缀，应该这样写：

const queryText = "INSERT INTO myTable (username) VALUES ('user_' || $1)";
const res = await client.query(queryText, [username]);
// 插入后username字段的值为"user_test_user"

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