Spring Boot 3中Many-to-Many请求Payload序列化异常问题求助

核心问题 #

1. 多对多关联维护端错误：你的User是关联关系的维护端（持有@JoinTable注解），Invoice的users字段是被维护端（mappedBy = "invoices"）。JPA只会处理维护端集合的变更，直接保存Invoice时，不会自动更新关联表users_invoices。
2. 反序列化转换失败：前端传入的用户ID无法直接被Spring转换成User实体对象，默认情况下Jackson不知道如何将ID数组映射为List<User>。

解决方案 #

方案1：使用DTO分离请求模型（推荐最佳实践） #

实体类不应直接作为请求参数，避免序列化问题和业务逻辑耦合，创建专门的请求DTO：

1.1 定义Invoice创建DTO

@Data
public class InvoiceCreateDTO {
    // 复制Invoice的其他业务字段（如金额、日期等）
    private BigDecimal amount;
    private LocalDate invoiceDate;
    // 接收用户ID列表
    private List<Long> userIds;
}

1.2 修改控制器与服务逻辑

@RestController
@RequestMapping("/invoices")
public class InvoiceController {
    private final InvoiceRepository invoiceRepository;
    private final UserRepository userRepository;

    // 构造注入
    public InvoiceController(InvoiceRepository invoiceRepository, UserRepository userRepository) {
        this.invoiceRepository = invoiceRepository;
        this.userRepository = userRepository;
    }

    @PostMapping("")
    @Transactional
    public Invoice saveInvoice(@RequestBody InvoiceCreateDTO invoiceDto){
        // 1. 根据ID查询用户实体（确保用户存在）
        List<User> users = userRepository.findAllById(invoiceDto.getUserIds());
        if(users.size() != invoiceDto.getUserIds().size()){
            throw new IllegalArgumentException("部分用户ID不存在");
        }

        // 2. 创建Invoice实体并复制字段
        Invoice invoice = new Invoice();
        invoice.setAmount(invoiceDto.getAmount());
        invoice.setInvoiceDate(invoiceDto.getInvoiceDate());
        // 其他字段赋值...

        // 3. 维护关联关系（操作维护端User的invoices集合）
        users.forEach(user -> user.getInvoices().add(invoice));

        // 4. 保存实体，JPA会自动更新关联表
        invoiceRepository.save(invoice);
        userRepository.saveAll(users);
        
        return invoice;
    }
}

1.3 请求体示例

{
    "amount": 100.00,
    "invoiceDate": "2024-05-20",
    "userIds": [1, 2]
}

方案2：配置Jackson自动转换ID为实体（不推荐直接用实体接收） #

如果一定要直接用Invoice实体接收请求，需要配置Jackson Hibernate模块实现ID到实体的自动加载：

2.1 添加Jackson Hibernate依赖（Maven）

<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-hibernate6</artifactId>
</dependency>

2.2 配置Jackson模块

@Configuration
public class JacksonConfig {
    @Bean
    public Module hibernateModule() {
        Hibernate6Module module = new Hibernate6Module();
        // 允许通过ID加载关联实体
        module.enable(Hibernate6Module.Feature.FORCE_LAZY_LOADING);
        return module;
    }
}

2.3 实体添加序列化标识

在User和Invoice实体上添加@JsonIdentityInfo避免循环引用，并支持ID反序列化：

@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
@Data
@NoArgsConstructor
@Entity(name = "users")
public class User extends Audit {
    // ... 原有代码
}

@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
@Data
@NoArgsConstructor
@Entity(name = "invoices")
public class Invoice extends Audit {
    // ... 原有代码
}

2.4 请求体示例

{
    "amount": 100.00,
    "invoiceDate": "2024-05-20",
    "users": [{"id": 1}, {"id": 2}]
}

2.5 修正服务层逻辑

即使反序列化成功，仍需操作维护端集合确保关联表更新：

// 在invoiceService.createInvoice方法中添加
public Invoice createInvoice(Invoice invoice) {
    // 遍历users，将当前invoice加入每个user的invoices集合
    invoice.getUsers().forEach(user -> user.getInvoices().add(invoice));
    return invoiceRepository.save(invoice);
}

关键注意事项 #

• 多对多关联中，只有维护端的集合变更会触发关联表更新，永远不要依赖被维护端的集合操作关联关系。
• 尽量使用DTO作为请求/响应模型，实体类专注于数据库映射，避免序列化逻辑污染持久化逻辑。
• 若使用方案2，需确保请求中的用户ID对应的实体已存在于数据库中，否则会抛出EntityNotFoundException。

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