Spring Boot更新嵌套JSON对象时PUT请求因用户名重复失败

嘿，这个问题我之前也碰到过！核心原因应该是你的UserLogin实体里的username字段加了唯一约束（比如@Column(unique = true)），而当你发起PUT请求时，框架（比如JPA）默认会对整个实体做唯一性校验——哪怕你没改用户名，它也会把传入的实体和数据库里的记录对比，误以为你要重复插入同一个用户名，所以抛出了"Duplicate entry on the username"错误。

下面给你几个实用的解决办法，按推荐程度排序：

方法一：基于现有实体做增量更新（最常用） #

不要直接把前端传来的更新实体直接存到数据库，而是先从数据库里查出当前的Customer和关联的UserLogin，只更新需要修改的字段，保留原用户名不变。

比如你的CustomerService里的更新方法可以改成这样：

public Customer updateCustomer(Long customerId, Customer updatedCustomer) {
    // 先从数据库获取已存在的客户实体
    Customer existingCustomer = customerRepository.findById(customerId)
            .orElseThrow(() -> new IllegalArgumentException("Customer not found with id: " + customerId));
    
    // 更新Customer的非登录相关字段（比如姓名、地址等）
    existingCustomer.setFullName(updatedCustomer.getFullName());
    existingCustomer.setEmail(updatedCustomer.getEmail());
    existingCustomer.setPhoneNumber(updatedCustomer.getPhoneNumber());
    
    // 如果需要更新密码，只修改密码字段，用户名保持原有的不变
    UserLogin existingLogin = existingCustomer.getLogin();
    if (updatedCustomer.getLogin() != null && updatedCustomer.getLogin().getPassword() != null) {
        existingLogin.setPassword(updatedCustomer.getLogin().getPassword());
        // 这里可以加密码加密逻辑，比如BCrypt
        // existingLogin.setPassword(passwordEncoder.encode(updatedCustomer.getLogin().getPassword()));
    }
    
    // 保存修改后的实体，此时只有变更的字段会被更新，用户名没动不会触发唯一约束校验
    return customerRepository.save(existingCustomer);
}

方法二：自定义SQL更新语句（适合复杂场景） #

如果你的更新逻辑比较固定，可以在CustomerRepository里写自定义的更新Query，只更新需要的字段，完全避开用户名的校验：

public interface CustomerRepository extends JpaRepository<Customer, Long> {
    @Modifying
    @Transactional
    @Query("UPDATE Customer c SET c.fullName = :fullName, c.email = :email, c.login.password = :password WHERE c.id = :customerId")
    void updateCustomerDetails(@Param("customerId") Long customerId, 
                               @Param("fullName") String fullName, 
                               @Param("email") String email,
                               @Param("password") String password);
}

然后在CustomerService里调用这个方法就行，这种方式直接执行SQL更新，不会触发JPA的实体校验，效率也更高。

方法三：调整实体字段的更新规则（谨慎使用） #

如果你确定业务上永远不需要修改用户名，可以给UserLogin的username字段加上updatable = false属性，这样框架在生成更新语句时会自动忽略这个字段，自然不会触发唯一约束：

@Entity
public class UserLogin {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(unique = true, updatable = false) // 这里加updatable=false
    private String username;
    
    private String password;
    
    // getter、setter、构造方法...
}

不过这个方法有局限性——以后如果业务需要修改用户名，就得改代码了，所以只适合明确不需要修改用户名的场景。

总结一下，最稳妥的还是方法一，既灵活又符合JPA的最佳实践，能完美解决你不修改用户名更新客户详情的需求。

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