Spring Boot 3 Rest Controller返回关联对象格式不一致问题

控制台打印能看到完整的noEnseignant对象，但接口返回时时而ID时而完整对象，核心原因是懒加载未触发或者Jackson序列化时的处理逻辑差异，以下是几种靠谱的解决方法：

1. 调整关联的加载策略 #

多对一关联默认是懒加载（FetchType.LAZY），接口序列化时如果关联对象没被初始化，Jackson只会序列化ID。直接把加载类型改成EAGER就能强制加载完整对象：

@ManyToOne(fetch = FetchType.EAGER)
@JoinColumn(name = "no_enseignant")
private Enseignant noEnseignant;

注意：如果数据量较大，EAGER可能拖慢查询性能，这种情况建议用下面的实体图或查询加载方式。

2. 配置Jackson强制序列化懒加载对象 #

如果不想改加载策略，给Jackson加Hibernate模块，让它能序列化懒加载的代理对象：
首先加Maven依赖（对应你的Spring Boot 3版本，Jackson版本通常和Boot一致）：

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

然后写个Jackson配置类：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.hibernate6.Hibernate6Module;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        Hibernate6Module hibernateModule = new Hibernate6Module();
        // 开启强制加载懒加载对象
        hibernateModule.enable(Hibernate6Module.Feature.FORCE_LAZY_LOADING);
        mapper.registerModule(hibernateModule);
        return mapper;
    }
}

3. 查询时主动加载关联对象 #

用Spring Data JPA的JOIN FETCH在查询时直接把关联对象加载出来，避免懒加载：
在UniteEnseignement的Repository里加个查询方法：

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import java.util.List;

public interface UniteEnseignementRepository extends JpaRepository<UniteEnseignement, UniteEnseignementId> {
    @Query("SELECT u FROM UniteEnseignement u JOIN FETCH u.noEnseignant")
    List<UniteEnseignement> findAllWithEnseignant();
}

Controller里调用这个方法替代默认的findAll()，返回的列表就都带完整的Enseignant对象了。

4. 处理循环引用问题 #

如果Enseignant类里也有对UniteEnseignement的一对多关联，会触发Jackson的循环引用截断，导致只返回ID。给关联字段加注解解决：

// UniteEnseignement类的关联字段
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "no_enseignant")
@JsonManagedReference
private Enseignant noEnseignant;

// Enseignant类的反向关联字段
@OneToMany(mappedBy = "noEnseignant")
@JsonBackReference
private List<UniteEnseignement> uniteEnseignements;

@JsonManagedReference标记主动序列化的一方，@JsonBackReference标记被忽略的反向关联，这样就能正常序列化完整对象了。

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