Spring Boot保存ParkingFacility失败：关联未持久化City实例报错

错误原因 #

你遇到的问题核心是：保存ParkingFacility时，它关联的City是未被持久化的瞬态对象（在ParkingFacilityMapper里直接new City(...)创建，没有生成持久化ID）。当前你在City的@OneToMany上配置了CascadeType.ALL，但这个级联是从City到ParkingFacility的方向——只有当你保存City时，才会级联保存它关联的停车场。而你现在是直接保存ParkingFacility，这个方向的级联规则不生效，所以Hibernate报错要求先处理关联的瞬态City。

解决方案 #

1. 修正关联级联配置（关键）

在ParkingFacility的@ManyToOne注解上添加级联规则，让保存/更新停车场时，自动处理关联的城市：

@ManyToOne(fetch = FetchType.EAGER, cascade = {CascadeType.PERSIST, CascadeType.MERGE})
@JoinColumn(name = "city_id", nullable = false) // 明确外键字段，避免隐式生成
protected City city;

• CascadeType.PERSIST：如果城市是新创建的，会自动持久化到数据库；
• CascadeType.MERGE：如果城市已存在（从数据库查询得到），会自动合并更新；
• 不建议直接用CascadeType.ALL，避免误删除关联城市（除非业务逻辑允许）。

2. 修改Mapper逻辑，避免创建重复城市

业务逻辑上，停车场应该属于已存在的城市，而非每次创建停车场都新建城市。所以要先从数据库查询城市，不存在时再创建：

// 需将CityRepository注入Mapper（若Mapper为Spring Bean），或在Service层处理查询逻辑
public static ParkingFacility toFacility(ParkingFacilityDto facilityDto, CityRepository cityRepo) {
    String formattedCityName = InputFormatter.formatCityName(facilityDto.getCity());
    // 查询同名城市，不存在则创建新城市
    City city = cityRepo.findByName(formattedCityName)
            .orElseGet(() -> {
                City newCity = new City();
                newCity.setName(formattedCityName);
                // 注意：City的code字段为唯一非空约束，需补充编码生成/赋值逻辑
                newCity.setCode(/* 生成唯一城市编码的逻辑，比如缩写+随机数 */);
                return newCity;
            });

    return ParkingFacility.builder()
            .name(facilityDto.getName())
            .capacity(facilityDto.getCapacity())
            .availableCapacity(facilityDto.getAvailableCapacity())
            .city(city)
            .build();
}

3. （可选）完善双向关联一致性

若要维护双向关联的完整性，设置停车场的城市时，同时将停车场添加到城市的关联列表中，避免数据不一致：

// 在ParkingFacility类中添加setCity方法逻辑
public void setCity(City city) {
    this.city = city;
    if (!city.getParkingFacilities().contains(this)) {
        city.getParkingFacilities().add(this);
    }
}

或者在Mapper中手动维护：

ParkingFacility facility = ParkingFacility.builder()
        // ...其他属性赋值
        .city(city)
        .build();
city.getParkingFacilities().add(facility);

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