为何无法向JPA创建的REST API端点发起POST请求（嵌套实体场景）

学习Angular时，用Spring Boot提供REST API，CRUD操作中查询、删除功能正常，但创建包含嵌套User实体的Order时失败。Postman测试返回非空约束错误，后端无额外报错信息。

环境依赖 #

pom.xml包含以下依赖：

• spring-boot-starter-data-jpa
• spring-boot-starter-data-rest
• mysql-connector-j
• lombok

实体与仓库代码 #

Order实体 #

import jakarta.persistence.*;
import lombok.Getter;
import lombok.RequiredArgsConstructor;
import lombok.Setter;

@Entity
@Getter
@Setter
@RequiredArgsConstructor
@Table(name = "orders")
public class Order {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;
    private String orderNumber;
    private String itemName;
    @ManyToOne(fetch = FetchType.EAGER)
    @JoinColumn(name="user_id", referencedColumnName = "id", nullable = false)
    private User user;
}

User实体 #

import jakarta.persistence.*;
import lombok.Getter;
import lombok.RequiredArgsConstructor;
import lombok.Setter;

@Entity
@Getter
@Setter
@RequiredArgsConstructor
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;
    private String firstName;
    private String lastName;
    private String email;
}

仓库接口 #

import com.suhitomi.angulartest.entity.Order;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.web.bind.annotation.CrossOrigin;

@CrossOrigin
public interface OrderRepository extends JpaRepository<Order, Integer> {}

import com.suhitomi.angulartest.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.web.bind.annotation.CrossOrigin;

@CrossOrigin
public interface UserRepository extends JpaRepository<User, Integer> {
}

测试细节 #

• 若将Order的user字段改为Integer类型，POST请求可正常执行；
• 保留User类型时，因非空约束创建失败；移除非空约束后，订单创建成功但user_id字段为null；
• Postman请求体：

{
    "orderNumber": "111333",
    "itemName": "TV",
    "user": {
        "id": 1
    }
}

• 报错信息：

{
    "cause": {
        "cause": null,
        "message": "not-null property references a null or transient value : com.suhitomi.angulartest.entity.Order.user"
    },
    "message": "not-null property references a null or transient value : com.suhitomi.angulartest.entity.Order.user"
}

Spring Data REST默认处理关联实体时，要求传入已持久化资源的URI，而非仅带id的对象。你传入的{"id":1}是未被JPA管理的临时对象，Spring无法将其关联到数据库中已存在的User实例，因此触发非空约束错误。

方案1：使用HAL格式引用关联资源 #

修改Postman请求体，将user字段替换为对应User资源的URI：

{
    "orderNumber": "111333",
    "itemName": "TV",
    "user": "/users/1"
}

Spring Data REST会自动解析该URI，获取对应的持久化User实例并关联到Order。

方案2：自定义控制器手动处理关联 #

如果不想使用URI格式，可以自定义Order的POST接口，手动查询User并关联：

import com.suhitomi.angulartest.entity.Order;
import com.suhitomi.angulartest.entity.User;
import com.suhitomi.angulartest.repository.OrderRepository;
import com.suhitomi.angulartest.repository.UserRepository;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/api/orders")
@CrossOrigin
public class OrderController {

    private final OrderRepository orderRepository;
    private final UserRepository userRepository;

    public OrderController(OrderRepository orderRepository, UserRepository userRepository) {
        this.orderRepository = orderRepository;
        this.userRepository = userRepository;
    }

    @PostMapping
    public ResponseEntity<Order> createOrder(@RequestBody Order order) {
        User existingUser = userRepository.findById(order.getUser().getId())
                .orElseThrow(() -> new RuntimeException("User not found with id: " + order.getUser().getId()));
        order.setUser(existingUser);
        Order savedOrder = orderRepository.save(order);
        return new ResponseEntity<>(savedOrder, HttpStatus.CREATED);
    }
}

此时Postman可继续使用原请求体格式，发送请求到/api/orders接口。

方案3：配置Spring Data REST支持嵌套实体绑定 #

通过自定义RepositoryRestConfigurer，允许Spring Data REST直接绑定嵌套的关联实体：

import org.springframework.context.annotation.Configuration;
import org.springframework.data.rest.core.config.RepositoryRestConfiguration;
import org.springframework.data.rest.webmvc.config.RepositoryRestConfigurer;
import org.springframework.web.servlet.config.annotation.CorsRegistry;

@Configuration
public class RestConfig implements RepositoryRestConfigurer {

    private final UserRepository userRepository;

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

    @Override
    public void configureRepositoryRestConfiguration(RepositoryRestConfiguration config, CorsRegistry cors) {
        config.getEntityLookup().registerLookup(User.class, User::getId, userRepository::findById);
    }
}

此配置让Spring Data REST能够识别传入的带id的User对象，自动查询对应的持久化实例。

内容的提问来源于stack exchange，提问作者Tamás Suhajda