SymmetricDS设置虚拟PK后仍出现重复数据的原因咨询

结合你描述的配置和异常现象，咱们从SymmetricDS的核心逻辑和表配置差异入手，拆解可能的成因：

1. 目标表缺少联合唯一约束，数据库层面未拦截重复 #

SymmetricDS的虚拟主键只是用来在同步过程中匹配源端和目标端的行，决定是执行更新还是插入，但它不会自动在目标表创建数据库级别的唯一性约束。如果你的目标表没有给Num + DateTime添加联合唯一索引/约束：

• 当源端本身存在Num + DateTime相同但ID不同的记录（因为源端主键是自增ID，允许这种情况），同步时每个源端的INSERT事件都会触发目标端的INSERT（UpdateFirst对INSERT事件的逻辑是先尝试更新，找不到就插入），最终目标端就会出现重复行。
• 其他同配置表正常，大概率是因为那些表的目标端提前创建了联合唯一约束，数据库直接拦截了重复插入。

2. UpdateFirst的生效逻辑被异常打断 #

你设置了UpdateFirst=1，理论上SymmetricDS会先尝试用虚拟主键匹配目标端行，更新失败（影响行数为0）再插入，但以下情况会导致这个逻辑失效：

• 变更事件的类型识别错误：如果源端连续插入两条Num + DateTime相同的记录，这两个都是INSERT事件，每个事件都会执行「更新（无匹配）→ 插入」的流程，最终产生重复。
• 虚拟主键字段的变更日志不完整：如果SymmetricDS在捕获源端变更时，没有正确记录Num或DateTime的字段值（比如字段被误配置为不捕获），导致更新时无法匹配到目标端已存在的行，转而插入新行。

3. 源端与目标端的字段类型不匹配 #

如果Num或DateTime在源端和目标端的字段类型、精度不一致：

• 比如源端DateTime包含毫秒，目标端只保留到秒，同步后目标端的DateTime值被截断，看起来相同，但源端的原始变更日志里的DateTime是带毫秒的，导致两次同步的虚拟主键匹配逻辑认为是不同行，最终插入重复。
• 再比如源端Num是DECIMAL(10,2)，目标端是INT，同步时Num的值被取整，导致原本不同的源端记录在目标端变成相同的Num + DateTime，进而出现重复。

4. 同步配置的隐性差异 #

虽然你说其他表配置相同，但可能存在隐性差异：

• 该表的同步路由规则是否有特殊设置？比如多个节点同时同步同一批源端数据，导致重复插入。
• 该表的初始加载与增量同步是否冲突？比如初始加载时已经导入了一行，后续增量同步又因为某种原因重新插入了一次（比如初始加载的变更日志未被正确标记为已处理）。

1. 先检查目标表：是否给Num和DateTime创建了联合唯一约束？如果没有，补上后就能从数据库层面阻止重复。
2. 查看源端数据：确认是否存在Num + DateTime完全相同的多行记录（源端因为ID是主键，允许这种情况）。
3. 查看SymmetricDS的变更日志表（比如sym_data）：找到对应重复记录的事件，看是INSERT还是UPDATE类型，判断同步逻辑的执行路径。
4. 校验字段类型：对比源端和目标端Num、DateTime的字段类型、精度、时区是否完全一致。
5. 核对配置：确认该表的转换规则中，UpdateFirst=1是否真的生效，以及Num、DateTime是否被正确标记为虚拟主键（pk:1）。

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