PostgreSQL序列引用报错：relation 'customers_sq'不存在，求调试方法

问题场景 #

在TypeScript中执行PostgreSQL的Upsert操作时，遇到序列找不到的错误，相关代码如下：

let SAVE_CUSTOMER = `
INSERT INTO "db"."customers" ("id", "name")
VALUES (NEXTVAL('customers_sq'), $1)
ON CONFLICT ("id") DO UPDATE
  SET "name" = $1;
`;

function saveCustomer(name: string) {
  datasource.query(SAVE_CUSTOMER, name)
}

相关信息：

• 数据库名称：db
• 表名：customers
• 主键列：id
• 其他列：name

收到的错误信息：

error: i: relation "customers_sq" does not exist

已尝试但无效的修改：

• 修改为NEXTVAL('db'.'customers_sq')
• 修改为NEXTVAL("db"."customers_sq")
• 修改为NEXTVAL("customers_sq")

确认数据库查看器中存在全小写的customers_sq序列。

调试建议 #

• 确认序列的完整限定名
  登录PostgreSQL终端，执行SELECT * FROM pg_sequence WHERE seqrelid = 'customers_sq'::regclass;，或用\ds命令列出所有序列，检查序列所属的schema。若序列不在默认的public schema下，需使用完整的schema.序列名格式，正确写法示例：NEXTVAL('db.customers_sq')（单引号包裹整个名称），或NEXTVAL(\\"db\\".\\"customers_sq\\")（TypeScript模板字符串中双引号需转义）。

• 检查当前会话的搜索路径
  在终端执行SHOW search_path;，查看当前连接的schema搜索路径。如果序列所在的schema不在路径中，PostgreSQL无法自动找到它。可临时设置路径：SET search_path TO db, public;，或在数据库连接时指定默认schema，也可在SQL中直接使用完整限定名。

• 测试SQL语句的原始有效性
  将拼接后的完整SQL（替换$1为实际值，比如'test'）直接在PostgreSQL终端执行。若终端能正常运行，说明问题出在TypeScript的字符串处理或数据库驱动上；若终端同样报错，需排查数据库端的序列引用问题。

• 验证序列权限
  检查执行SQL的数据库用户是否拥有customers_sq序列的访问权限，必要时执行授权命令：GRANT USAGE ON SEQUENCE db.customers_sq TO 你的数据库用户名;（需替换为实际用户名和schema）。

• 核对序列与主键的绑定关系
  若id列是通过SERIAL或IDENTITY自动生成的，默认序列名称通常为customers_id_seq。可执行SELECT column_default FROM information_schema.columns WHERE table_name = 'customers' AND column_name = 'id';查看id列的默认值，确认对应的序列名称是否正确。

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