Spring Boot实体含外键时的保存方法及idfuncao非空问题解决

针对你遇到的插入Servidor时idfuncao不可为null的问题，按以下步骤调整即可：

1. 确保实体类关联映射正确 #

因为Servidor（员工）和Funcao（职位）是一对多关系（一个职位对应多个员工），所以在实体类中要正确配置JPA关联：

Servidor实体类 #

@Entity
public class Servidor {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String nome;

    // 关联职位，optional = false强制外键不为空
    @ManyToOne(optional = false)
    @JoinColumn(name = "idfuncao") // 对应数据库的外键字段名
    private Funcao funcao;

    // 生成getter、setter和必要的构造方法
}

Funcao实体类 #

@Entity
public class Funcao {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long idfuncao;
    private String nomeFuncao;

    // 关联员工集合，mappedBy指向Servidor中的funcao字段
    @OneToMany(mappedBy = "funcao")
    private List<Servidor> servidores;

    // 生成getter、setter和必要的构造方法
}

2. 修改Controller的createServidor方法 #

通常有两种可靠的处理方式：

方式一：通过职位ID关联推荐使用 #

前端只传入员工基本信息和职位ID，后端先查询对应的职位实体，再关联到员工对象后保存：

第一步：创建DTO接收前端参数

public class ServidorRequest {
    private String nome;
    private Long funcaoId; // 前端传入的职位ID

    // 生成getter、setter
}

第二步：修改Controller方法

@RestController
@RequestMapping("/servidores")
public class ServidorController {
    private final ServidorRepository servidorRepo;
    private final FuncaoRepository funcaoRepo;

    // 构造方法注入（替代@Autowired，更规范）
    public ServidorController(ServidorRepository servidorRepo, FuncaoRepository funcaoRepo) {
        this.servidorRepo = servidorRepo;
        this.funcaoRepo = funcaoRepo;
    }

    @PostMapping
    public ResponseEntity<Servidor> createServidor(@RequestBody ServidorRequest request) {
        // 根据ID查询职位，不存在则抛出异常
        Funcao funcao = funcaoRepo.findById(request.getFuncaoId())
                .orElseThrow(() -> new RuntimeException("指定的职位不存在"));
        
        // 创建员工对象并关联职位
        Servidor servidor = new Servidor();
        servidor.setNome(request.getNome());
        servidor.setFuncao(funcao);
        
        // 保存并返回结果
        Servidor savedServidor = servidorRepo.save(servidor);
        return ResponseEntity.ok(savedServidor);
    }
}

方式二：直接传入职位对象信息 #

如果前端能传入包含ID的职位JSON，也可以直接绑定到Servidor对象（但要确保职位已存在于数据库）：

@PostMapping
public ResponseEntity<Servidor> createServidor(@RequestBody Servidor servidor) {
    // 确保传入的servidor.funcao.idfuncao对应数据库中已存在的职位
    Servidor savedServidor = servidorRepo.save(servidor);
    return ResponseEntity.ok(savedServidor);
}

前端传入的JSON示例：

{
    "nome": "Gustavo",
    "funcao": {
        "idfuncao": 1
    }
}

3. 数据库层面验证 #

确保MySQL中servidor表的idfuncao字段设置为NOT NULL，并且存在外键约束指向funcao表的idfuncao字段：

CREATE TABLE funcao (
    idfuncao BIGINT PRIMARY KEY AUTO_INCREMENT,
    nome_funcao VARCHAR(50) NOT NULL
);

CREATE TABLE servidor (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    nome VARCHAR(100) NOT NULL,
    idfuncao BIGINT NOT NULL,
    FOREIGN KEY (idfuncao) REFERENCES funcao(idfuncao)
);

常见问题排查 #

• 保存员工前，必须确保关联的职位已存在于数据库中，否则会触发外键约束错误
• 检查实体类@JoinColumn的name属性是否与数据库外键字段名完全一致（大小写敏感）

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