如何在Spring Boot中向MySQL关联表插入嵌套JSON数据？

你遇到的问题主要源于两点：一是JSON结构里的ID是数组，但你使用了一对一关联注解@OneToOne（结构不匹配）；二是未正确配置JPA的级联操作和字段映射，导致嵌套数据无法被持久化。下面分步骤给出解决方案，同时优化数据库结构。

首先调整表名和字段名，避免使用SQL关键字（如index是MySQL保留字），同时明确关联关系：

1. users表（替换原index为user_id）：

CREATE TABLE users (
    user_id VARCHAR(20) PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    number VARCHAR(20) NOT NULL
);

2. user_ids表（避免用ID作为表名，语义更清晰）：

CREATE TABLE user_ids (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL UNIQUE,
    email VARCHAR(100) NOT NULL UNIQUE,
    user_id VARCHAR(20) NOT NULL,
    FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE
);

注：如果是一对一关系，给user_id加唯一约束；如果是一对多（一个用户对应多个ID），则无需唯一约束。

根据调整后的数据库，编写实体类并配置关联关系：

1. User实体 #

import jakarta.persistence.*;
import lombok.Data;

@Entity
@Table(name = "users")
@Data
public class User {
    @Id
    @Column(name = "user_id")
    private String userId; // 对应JSON中的index字段

    private String name;
    private String number;

    // 一对一关联UserID，级联所有操作（保存/更新/删除）
    @OneToOne(mappedBy = "user", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    private UserId userIdEntity;
}

2. UserId实体 #

import jakarta.persistence.*;
import lombok.Data;

@Entity
@Table(name = "user_ids")
@Data
public class UserId {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;

    private String username;
    private String email;

    // 外键关联User，指定数据库外键列名
    @OneToOne
    @JoinColumn(name = "user_id", nullable = false)
    private User user;
}

前端JSON里的ID是数组，而我们用的是一对一关联，因此用DTO中转适配结构：

1. UserDTO #

import lombok.Data;
import java.util.List;

@Data
public class UserDTO {
    private String index;
    private String name;
    private String number;
    private List<IdDTO> ID; // 对应JSON中的ID数组
}

2. IdDTO #

import lombok.Data;

@Data
public class IdDTO {
    private String username;
    private String email;
}

继承JpaRepository提供基础持久化能力：

import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, String> {
}

public interface UserIdRepository extends JpaRepository<UserId, Integer> {
}

处理DTO到实体的转换，同时开启事务保证数据一致性：

import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.util.List;

@Service
public class UserService {
    private final UserRepository userRepository;

    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    @Transactional // 确保两张表同时插入成功或失败
    public void saveUsers(List<UserDTO> userDTOList) {
        for (UserDTO dto : userDTOList) {
            // 转换UserDTO到User实体
            User user = new User();
            user.setUserId(dto.getIndex());
            user.setName(dto.getName());
            user.setNumber(dto.getNumber());

            // 转换IdDTO到UserId实体（取数组第一个元素，适配一对一关系）
            if (!dto.getID().isEmpty()) {
                IdDTO idDto = dto.getID().get(0);
                UserId userIdEntity = new UserId();
                userIdEntity.setUsername(idDto.getUsername());
                userIdEntity.setEmail(idDto.getEmail());
                userIdEntity.setUser(user); // 建立关联
                user.setUserIdEntity(userIdEntity);
            }

            // 级联保存，只需保存User，UserId会自动插入
            userRepository.save(user);
        }
    }
}

接收POST请求并调用Service处理：

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;
import java.util.Map;

@RestController
public class UserController {
    private final UserService userService;

    public UserController(UserService userService) {
        this.userService = userService;
    }

    @PostMapping("/users/batch")
    public String batchSaveUsers(@RequestBody Map<String, List<UserDTO>> request) {
        List<UserDTO> userDTOList = request.get("users");
        userService.saveUsers(userDTOList);
        return "批量插入成功";
    }
}

• 用DTO分离前后端模型：避免直接暴露JPA实体给前端，防止数据泄露或字段不匹配问题。
• 强制事务管理：多表操作必须加@Transactional，保证数据一致性。
• 字段命名规范：数据库用下划线命名，实体类用驼峰命名，通过@Column映射，避免SQL关键字。
• 参数校验：在DTO上添加@NotNull、@Email等注解，配合@Valid在Controller层校验输入，比如：

  @Data
  public class IdDTO {
      @NotNull(message = "用户名不能为空")
      private String username;
      @Email(message = "邮箱格式不正确")
      private String email;
  }
  

• 用Lombok简化代码：减少重复的getter/setter、构造方法代码。
• 添加日志记录：在Service层记录数据插入过程，方便排查问题。

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