调用ModelService.save()时Hybris执行逻辑及唯一键冲突报错解决方案

首先，咱们先拆解你遇到的问题，一步步理清原因和解决方案：

为什么会抛出这个异常？ #

你看到的InterceptorException: ambiguous unique keys是UniqueAttributesInterceptor在验证阶段触发的——这个拦截器的核心作用就是确保模型的唯一属性在数据库中不会出现重复值。当你调用ModelService.save()时，如果你的模型是新创建的（PK为null），且设置的唯一属性已经在数据库中存在，这个拦截器会直接判定你要插入一条重复记录，抛出异常阻止操作继续。

你疑惑的点：ModelService.save()本身就是INSERT_UPDATE，为什么还会报错？ #

没错，ModelService.save()的设计逻辑确实是自动判断执行INSERT还是UPDATE，但它的判断核心依据是模型的PK状态：

1. 如果模型的PK是null或者临时生成的（比如你直接new出来的模型实例），Hybris会先尝试通过唯一属性查询数据库中是否存在匹配记录；
2. 但这里有个关键顺序问题：UniqueAttributesInterceptor的验证是在PK匹配逻辑之前触发的——也就是说，拦截器先检查到唯一属性重复，直接报错，根本没走到后续判断是INSERT还是UPDATE的持久化环节。

简单说：ModelService.save()的INSERT_UPDATE逻辑是基于PK匹配的，而拦截器的检查在PK匹配之前，所以才会出现你觉得矛盾的报错情况。

不用Legacy Mode，怎么实现正确的INSERT_UPDATE？ #

核心思路是主动先通过唯一属性找到现有模型（如果存在），更新它的属性后再保存；如果不存在，再保存新模型。这样就能绕过拦截器的冲突检查，因为你保存的要么是已存在的模型（PK非null，执行UPDATE），要么是全新的无冲突模型（执行INSERT）。

示例代码（假设你的模型是MyCustomModel，唯一属性是code）：

@Autowired
private ModelService modelService;
@Autowired
private FlexibleSearchService flexibleSearchService;

public void saveOrUpdateModel(MyCustomModel inputModel) {
    // 构建FlexibleSearch查询，通过唯一属性查找现有模型
    final String query = "SELECT {pk} FROM {MyCustomModel} WHERE {code} = ?code";
    final Map<String, Object> params = new HashMap<>();
    params.put("code", inputModel.getCode());
    
    final SearchResult<MyCustomModel> searchResult = flexibleSearchService.search(query, params);
    if (!searchResult.getResult().isEmpty()) {
        // 找到现有模型，将新属性复制到现有模型中
        MyCustomModel existingModel = searchResult.getResult().get(0);
        // 示例：更新需要修改的属性，这里以name为例
        existingModel.setName(inputModel.getName());
        // 保存现有模型，执行UPDATE操作
        modelService.save(existingModel);
    } else {
        // 无匹配记录，保存新模型，执行INSERT操作
        modelService.save(inputModel);
    }
}

补充：ModelService.save()的完整执行流程 #

当你调用modelService.save(model)时，Hybris会按以下步骤执行：

1. 模型预处理：检查模型状态，处理临时PK，触发PrepareInterceptor；
2. 验证阶段：触发所有ValidateInterceptor（包括你遇到的UniqueAttributesInterceptor），验证失败直接抛出异常；
3. 持久化判断：根据模型PK状态和数据库查询结果，决定执行INSERT还是UPDATE：
   • 若模型PK非null且数据库存在该记录：执行UPDATE；
   • 若模型PK为null且数据库无匹配唯一属性记录：执行INSERT；
   • 若模型PK为null但数据库有匹配唯一属性记录：验证阶段已拦截，不会走到这一步；
4. 持久化执行：执行对应的SQL操作（INSERT/UPDATE）；
5. 后置处理：触发LoadInterceptor和AfterSaveListener，更新缓存、触发后续业务逻辑等。

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