ORA-00001唯一约束报错括号内仅为点号(.)的解决方法

排查步骤 #

• 开启会话级错误追踪抓取完整约束名
  首先执行命令开启错误栈追踪：ALTER SESSION SET EVENTS '1403 trace name errorstack level 3';，重新复现报错后，去Oracle用户dump目录下找到对应会话生成的trc trace文件，文件内会记录完整的约束名称。排查完成后执行ALTER SESSION SET EVENTS '1403 trace name errorstack off';关闭追踪，避免产生不必要的日志文件。
  约束名显示为点号通常是因为约束为Oracle自动生成的隐式约束、或约束名包含特殊字符、小写字符导致客户端显示异常。
• 定位操作表的所有唯一约束
  执行如下SQL查询你操作的表上绑定的所有唯一约束，注意替换SQL中的目标表名为实际操作的表名，Oracle元数据默认存储为大写，建议填写大写表名查询：

  SELECT uc.constraint_name, uc.index_name, ucc.column_name
  FROM user_constraints uc
  JOIN user_cons_columns ucc ON uc.constraint_name = ucc.constraint_name
  WHERE uc.table_name = '目标表名大写' 
    AND uc.constraint_type = 'U';
  

  根据返回的约束关联字段，即可定位到是哪组字段的唯一性校验被触发。
• 定位冲突的重复数据
  针对上一步查询到的唯一约束字段，执行如下SQL查找表中已存在的重复值：

  SELECT 唯一约束字段1, 唯一约束字段2, COUNT(*) AS 重复次数
  FROM 目标表名
  GROUP BY 唯一约束字段1, 唯一约束字段2
  HAVING COUNT(*) > 1;
  

  如果是插入操作，还可以对比待插入的数据集和表中已有数据，定位冲突的具体数值。

解决方法 #

• 隐式约束命名异常处理：如果是建表时直接给字段加UNIQUE属性未显式命名约束，Oracle会自动生成SYS_开头的隐式约束，容易出现显示异常。可以删除旧的隐式约束后显式创建命名约束，示例语句：

  -- 删除旧隐式约束
  ALTER TABLE 目标表名 DROP CONSTRAINT 查到的约束名;
  -- 显式创建命名的唯一约束
  ALTER TABLE 目标表名 ADD CONSTRAINT uk_表名_字段组合 UNIQUE (字段1,字段2);
  

• 特殊字符约束名处理：如果约束名包含小写字母、空格、特殊符号，操作时需要用双引号包裹约束名，示例：ALTER TABLE 目标表名 DROP CONSTRAINT "小写或带特殊字符的约束名";
• 数据冲突处理：定位到重复数据后，根据业务规则选择处理方案：删除表中冗余的重复数据、修改待插入/更新的冲突值、或者调整唯一约束的字段组合适配实际业务逻辑。
• 临时跳过约束校验（仅测试/数据迁移场景使用）：如果是数据迁移等临时场景需要跳过唯一约束校验，可以先禁用约束：ALTER TABLE 目标表名 DISABLE CONSTRAINT 约束名;，操作完成后务必重新开启约束并校验数据：ALTER TABLE 目标表名 ENABLE CONSTRAINT 约束名;

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