2627: Violation of PRIMARY KEY / UNIQUE KEY constraint. Cannot insert duplicate key in object (violación de restricción PRIMARY KEY / UNIQUE KEY; clave duplicada)

¿Qué significa?

Intentó insertar o actualizar un valor que ya existe en columnas protegidas por una restricción PRIMARY KEY o UNIQUE. No se aceptan claves duplicadas.

¿Por qué ocurre?

Insertar el mismo valor único por segunda vez, un UPDATE que colisiona con un valor existente, la ausencia de una comprobación de unicidad o dos peticiones concurrentes que generan la misma fila.

Cómo solucionarlo

Compruebe si la fila existe antes de insertarla o use MERGE / IF NOT EXISTS. Para inserciones idempotentes, aplique el patrón "INSERT ... WHERE NOT EXISTS". Capture el error y devuelva un mensaje significativo. Si realmente necesita datos duplicados, revise la restricción. Use IDENTITY o SEQUENCE para evitar colisiones al generar claves.