Spring JPA ManyToOne新增JSON数据时外键customer_id为null如何解决

核心问题原因 #

• 入参DTO未设计单独的customerId字段接收前端传入的整数ID，直接用Customer实体类接收参数时，JSON反序列化无法将数字类型ID自动转换为Customer实体对象，导致关联字段为空
• 实体类属性命名不遵守Java小驼峰规范（类名直接作为属性名、首字母大写），易引发Spring参数绑定、JPA映射的隐式错误
• Mapper层转换逻辑未根据传入的customerId查询数据库中持久态的Customer对象，直接赋值空的Customer属性，最终存库时外键为null
• Controller层参数名大小写不匹配，会直接导致参数绑定失败

分步修复操作 #

1. 调整FileDTO结构 #

新增Integer类型的customerId字段接收前端传入的外键ID，不要在新增入参中直接嵌套Customer实体：

@Data
public class FileDTO {
    private Integer id;
    private String file_name;
    // 接收前端传入的数字类型客户ID
    private Integer customerId;
}

2. 修正实体类不规范命名 #

严格遵循小驼峰命名规则，避免映射错误：

• Customer实体修正：

@NoArgsConstructor
@AllArgsConstructor
@Data
@Builder
@Entity
@Table(name = "customer")
public class Customer {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;
    // 原CustomerName改为小驼峰格式customerName
    private String customerName;
    private String email;
    // 原File集合属性改为files
    @OneToMany(mappedBy = "customer", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<File> files = new ArrayList<>();
}

• File实体修正：

@NoArgsConstructor
@AllArgsConstructor
@Data
@Builder
@Entity
@Table(name = "file")
public class File implements Serializable {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;
    private String file_name;
    // 原Customer属性改为小驼峰格式customer
    @ManyToOne
    @JoinColumn(name="customer_id")
    private Customer customer;
}

3. 修正Mapper转换逻辑 #

转换实体时，根据传入的customerId查询数据库中已存在的持久态Customer对象再关联，不要直接赋值空对象：

public class FileMapper {
    private static CustomerRepository customerRepository;

    // 构造注入CustomerRepository
    public FileMapper(CustomerRepository customerRepository) {
        FileMapper.customerRepository = customerRepository;
    }

    public static FileDTO toDto(File file){
        FileDTO fileDTO = new FileDTO();
        fileDTO.setId(file.getId());
        fileDTO.setFile_name(file.getFile_name());
        // 出参时回填客户ID
        if (file.getCustomer() != null) {
            fileDTO.setCustomerId(file.getCustomer().getId());
        }
        return fileDTO;
    }

    public static File toEntity(FileDTO fileDTO){
        File file = new File();
        file.setFile_name(fileDTO.getFile_name());
        // 根据传入ID查询客户后关联
        if (fileDTO.getCustomerId() != null) {
            Customer customer = customerRepository.findById(fileDTO.getCustomerId())
                    .orElseThrow(() -> new IllegalArgumentException("传入的客户ID不存在"));
            file.setCustomer(customer);
        }
        return file;
    }
}

4. 修正Controller层参数错误 #

统一参数命名，避免大小写不匹配导致的绑定失败：

@PostMapping(path = "/addFile")
public boolean addFile(@RequestBody FileDTO fileDTO) {
    return fileService.addFile(FileMapper.toEntity(fileDTO));
}

5. 确认前端传参格式 #

前端请求JSON直接传数字类型的customerId即可，不需要传递完整Customer对象：

{
    "file_name": "项目合同.pdf",
    "customerId": 3
}

注意：不要在File类的@ManyToOne注解上配置CascadeType.ALL，否则传入不存在的客户ID时会自动插入空的客户记录，保持当前无级联配置即可。

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