Spring Boot中Product与Tags一对多关联保存报错及JSON修正

我有Product和Tags两个实体模型，要建立一对多关联，计划用以下JSON保存产品和标签：

{
    "productName": "katon gokake 1",
    "product_desc": "ASDASasdasdasDASDA",
    "price": 250030.0,
    "category": {
        "id": 302
    },
    "tags": [
        {"tag_name": "new tag"},
        {"tag_name": "new tag"}
    ]
}

若JSON格式有误请修正。执行保存操作时报错：No primary or single unique constructor found for interface，以下是我的实体、仓库和服务层代码，请帮忙解决。

实体模型代码 #

Product实体 #

// Product实体
package com.example.springpractice.Models;
import jakarta.persistence.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.util.ArrayList;
import java.util.List;

@Data
@AllArgsConstructor
@NoArgsConstructor
@Entity
@Table
public class Product {
    @Id
    @GeneratedValue
    private int id;
    private String productName;
    private float price;
    private String product_desc;
    @ManyToOne
    private Category category;
    @OneToMany(cascade = CascadeType.ALL)
    private List<Tags> tags = new ArrayList<>();
}

Tags实体 #

// Tags实体
package com.example.springpractice.Models;
import jakarta.persistence.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@Entity
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "tags")
public class Tags {
    @Id
    @GeneratedValue
    private int id;
    private String tag_name;
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "product_id")
    private Product products;
}

仓库接口代码 #

Product仓库 #

// Product仓库
package com.example.springpractice.Repositories;
import com.example.springpractice.Models.Product;
import org.springframework.data.jpa.repository.JpaRepository;

public interface ProductRepository extends JpaRepository<Product, Integer> {
    Product findByProductName(String productName);
    Product findByCategoryId(int categoryId);
}

Tags仓库 #

// Tags仓库
package com.example.springpractice.Repositories;
import com.example.springpractice.Models.Tags;
import org.springframework.data.jpa.repository.JpaRepository;

public interface TagInterface extends JpaRepository<Tags, Integer> {
}

服务层代码 #

// 服务层
@Service
public class ProductService {
    @Autowired
    private ProductRepository productRepository;
    @Autowired
    private TagInterface tagInterface;

    public Product saveProduct(Product product, List<Tags> tags)
    {
        for(Tags tag : tags){
            tag.setProducts(product);
            tagInterface.save(tag);
        }
        product.setTags(tags);
        return productRepository.save(product);
    }
}

1. JSON格式说明 #

原JSON格式无语法错误，字段名与实体类属性完全匹配，可直接使用。

2. 报错核心原因 #

报错No primary or single unique constructor found for interface是因为：控制器层（未提供代码）大概率直接接收了List<Tags>接口类型的参数，Spring无法实例化接口（接口不能直接new对象），导致反序列化失败。

3. 具体修复步骤 #

步骤1：调整服务层方法逻辑 #

不需要单独传递List<Tags>参数，利用Product实体已有的tags列表，结合级联配置自动保存标签：

@Service
public class ProductService {
    @Autowired
    private ProductRepository productRepository;

    public Product saveProduct(Product product) {
        // 给每个标签绑定关联产品
        if (product.getTags() != null) {
            product.getTags().forEach(tag -> tag.setProducts(product));
        }
        // 依赖CascadeType.ALL，保存产品时自动级联保存标签
        return productRepository.save(product);
    }
}

删除手动调用tagInterface.save(tag)，因为Product的@OneToMany已配置cascade = CascadeType.ALL，级联操作会自动处理标签的保存。

步骤2：修正实体关联配置 #

当前Product的@OneToMany缺少mappedBy属性，会生成冗余中间表，需明确关联维护字段：

// Product实体中的tags字段修改为
@OneToMany(mappedBy = "products", cascade = CascadeType.ALL, orphanRemoval = true)
private List<Tags> tags = new ArrayList<>();

• mappedBy = "products"：指定由Tags实体的products字段维护关联关系
• orphanRemoval = true：当从产品的tags列表移除标签时，自动删除数据库中对应标签记录（可选，根据业务需求）

步骤3：控制器层接收完整Product对象 #

控制器需接收@RequestBody Product product，而非拆分参数：

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

    @PostMapping
    public ResponseEntity<Product> createProduct(@RequestBody Product product) {
        Product savedProduct = productService.saveProduct(product);
        return ResponseEntity.ok(savedProduct);
    }
}

Spring会自动将JSON反序列化为Product对象，其中的tags列表是实体类Tags的实例，而非接口，可正常实例化。

4. 可选优化点 #

• Tags实体的products字段建议改为product（单数更符合业务语义），同时同步修改Product中的mappedBy值和服务层的绑定代码
• 仓库接口TagInterface重命名为TagRepository，符合Spring Data JPA命名规范

内容的提问来源于stack exchange，提问作者Sakib ovi