Spring Data JPA中如何通过categoryId新增Product实体

首先先理清楚实体关系：通常食品系统里是一个Category对应多个Product，也就是Category是「一」，Product是「多」，所以Product实体应该用@ManyToOne关联Category，而不是反过来。如果你的实体关系搞反了，先调整过来，这是解决问题的基础。

1. 修正实体配置 #

Category实体（一的一方） #

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

    // 一对多关联Product，mappedBy指定Product里的category字段
    @OneToMany(mappedBy = "category", fetch = FetchType.LAZY)
    private List<Product> products = new ArrayList<>();

    // 构造器、getter、setter省略
}

Product实体（多的一方） #

@Entity
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private BigDecimal price;

    // 多对一关联Category，fetch默认是EAGER，也可以设为LAZY按需加载
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "category_id") // 指定数据库外键字段名
    private Category category;

    // 构造器、getter、setter省略
}

这里注意：@ManyToOne的cascade不需要设置（默认无），因为我们是关联已存在的Category，不需要级联保存/更新Category。

2. 实现仅传categoryId创建Product #

方式一：直接在Controller接收categoryId #

@RestController
@RequestMapping("/products")
public class ProductController {
    private final ProductService productService;

    public ProductController(ProductService productService) {
        this.productService = productService;
    }

    @PostMapping("/add")
    public ResponseEntity<Product> addProduct(@RequestParam String productName,
                                              @RequestParam BigDecimal price,
                                              @RequestParam Long categoryId) {
        Product savedProduct = productService.createProduct(productName, price, categoryId);
        return ResponseEntity.ok(savedProduct);
    }
}

方式二：用DTO接收参数（更规范） #

先定义ProductDTO：

public class ProductDTO {
    private String name;
    private BigDecimal price;
    private Long categoryId;

    // getter、setter省略
}

然后Controller接收DTO：

@PostMapping("/add")
public ResponseEntity<Product> addProduct(@RequestBody ProductDTO productDTO) {
    Product savedProduct = productService.createProductFromDTO(productDTO);
    return ResponseEntity.ok(savedProduct);
}

Service层实现核心逻辑 #

不管用哪种方式，核心都是先通过categoryId查询到Category实体，再关联到Product：

@Service
public class ProductService {
    private final ProductRepository productRepository;
    private final CategoryRepository categoryRepository;

    public ProductService(ProductRepository productRepository, CategoryRepository categoryRepository) {
        this.productRepository = productRepository;
        this.categoryRepository = categoryRepository;
    }

    public Product createProduct(String name, BigDecimal price, Long categoryId) {
        // 先查询Category，如果不存在可以抛自定义异常
        Category category = categoryRepository.findById(categoryId)
                .orElseThrow(() -> new RuntimeException("Category not found with id: " + categoryId));
        
        Product product = new Product();
        product.setName(name);
        product.setPrice(price);
        product.setCategory(category);
        
        return productRepository.save(product);
    }

    // DTO转换的方法
    public Product createProductFromDTO(ProductDTO productDTO) {
        Category category = categoryRepository.findById(productDTO.getCategoryId())
                .orElseThrow(() -> new RuntimeException("Category not found with id: " + productDTO.getCategoryId()));
        
        Product product = new Product();
        product.setName(productDTO.getName());
        product.setPrice(productDTO.getPrice());
        product.setCategory(category);
        
        return productRepository.save(product);
    }
}

如果想优化性能，避免全表查询Category，可以用EntityManager.getReference()，它会返回一个代理对象，只有当访问Category的非id字段时才会触发数据库查询：

// 替换Service里的category查询代码
Category category = entityManager.getReference(Category.class, categoryId);

3. 关于DTO传categoryId后categoryName的问题 #

不会自动填充categoryName，因为DTO只是用来传输数据的载体，本身不会和数据库交互。你需要在Service层查询到完整的Category实体并关联到Product，这样保存后的Product对象的category字段才会包含完整的Category信息（包括name）。

后续查询Product时，如果@ManyToOne的fetch设为FetchType.EAGER，会自动加载Category的所有字段；如果是FetchType.LAZY，则需要在查询Product时用JOIN FETCH来主动加载Category，比如在ProductRepository里写查询：

@Repository
public interface ProductRepository extends JpaRepository<Product, Long> {
    @Query("SELECT p FROM Product p JOIN FETCH p.category WHERE p.id = :id")
    Product findByIdWithCategory(Long id);
}

这样查询出来的Product的category字段就会有categoryName，不会是null。

为什么之前调整cascade和fetch没解决？ #

• cascade是用来控制级联操作的，比如保存Product时要不要同步保存Category，和你要的「关联已存在Category」无关，所以调整它没用。
• fetch只是控制查询时是否加载关联对象，不影响创建Product时的关联逻辑，所以也解决不了你的问题。

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