PostgreSQL插入报错：重复键违反唯一约束todo_task_key求助

错误根源 #

todo_task_key是PostgreSQL为todo表的task字段添加的唯一约束，第一次插入'Clean Kitchen'后，该值已存在于表中，后续重复插入相同的task值时，就会触发唯一约束校验失败，抛出约束违反错误。

解决办法 #

1. 移除唯一约束（若业务允许重复task） #

如果你的业务逻辑允许多条记录有相同的task内容，直接删除这个约束即可：

ALTER TABLE todo DROP CONSTRAINT todo_task_key;

2. 动态传入task参数，避免硬编码重复值 #

你当前的代码硬编码了插入的task值，每次调用都会插入完全相同的内容。修改代码，让函数接收动态参数：

async function registerPerson(person) {
    // 使用参数化查询，动态传入task和status
    const query = `
        INSERT INTO todo (task, status)
        VALUES ($1, $2)
        RETURNING id
     `;
    const values = [person.task, person.status];
    client.query(query, values, (err, res) => {
        if (err) {
            console.error(err);
            return;
        }
        console.log('Data insert successful');
        client.end();
    });
}

// 调用时传入不同的任务内容
registerPerson({ task: "Clean Kitchen", status: 0 });
// 下次调用可以传新任务，比如：
// registerPerson({ task: "Take out the trash", status: 0 });

3. 修复数据库客户端初始化问题 #

你定义了数据库凭证credentials但初始化Client时并未传入，导致可能使用默认配置连接数据库，修正如下：

const client = new Client(credentials);
client.connect();

4. 保留唯一约束，使用UPSERT逻辑（存在则更新） #

如果业务要求task必须唯一，不想触发错误的话，可以用PostgreSQL的ON CONFLICT实现"存在则更新，不存在则插入"的逻辑：

async function registerPerson(person) {
    const query = `
        INSERT INTO todo (task, status)
        VALUES ($1, $2)
        ON CONFLICT (task) DO UPDATE SET status = EXCLUDED.status
        RETURNING id
     `;
    const values = [person.task, person.status];
    client.query(query, values, (err, res) => {
        if (err) {
            console.error(err);
            return;
        }
        console.log('Data insert/upsert successful');
        client.end();
    });
}

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