Java Spring Boot POST方法保存时如何检测重复值？解决Role属性报错

PropertyReferenceException的触发逻辑是：Spring Data JPA解析派生查询方法名时，会按驼峰规则拆分方法名中的属性部分，去匹配对应实体类的字段。
你当前在RoleRepository中写的findByRole(String name)，会被解析为查找Role实体中**属性名为role**的字段做等值匹配，但实际你的Role实体存储角色名称的字段是name，根本不存在role这个属性，因此直接抛出解析错误。

注意：Spring Data JPA的派生查询方法名严格区分大小写，属性名拼写、大小写和实体字段不一致都会触发同类属性报错

1. 对齐Repository层的方法与实体属性 #

将Repository中的方法名改为和实体属性完全匹配的写法，避免属性解析报错：

import com.synesisit.commonmodule.acl.model.Role;
import org.springframework.data.jpa.repository.JpaRepository;

public interface RoleRepository extends JpaRepository<Role, Integer> {
    // 方法名必须严格匹配Role实体中存储角色名称的属性名
    // 若实体中角色名字段是name，就写findByName；如果是roleName，就写findByRoleName
    Role findByName(String name);
}

2. 补全Service层的缺失逻辑 #

你当前的Service类只实现了查询方法，没有实现Controller中调用的save方法，属于隐藏的报错点，同步修正查询方法的调用链路，同时优化注入方式避免循环依赖：

@Service
public class RoleService {

    // 用构造器注入替代字段@Autowired，降低容器耦合度
    private final RoleRepository roleRepository;

    public RoleService(RoleRepository roleRepository) {
        this.roleRepository = roleRepository;
    }

    public Role findByName(String name){
        return roleRepository.findByName(name);
    }

    // 补上Controller依赖的save方法
    public Role save(Role role) {
        return roleRepository.save(role);
    }
}

3. 修正Controller层的重复检测逻辑 #

同步替换方法调用名，补充空值处理避免无效查库：

@RestController
public class RoleController {
    private final RoleService roleService;

    public RoleController(RoleService roleService) {
        this.roleService = roleService;
    }

    @PostMapping("/role")
    public ResponseEntity<ApiResponse> createRole(@RequestBody @Valid Role role) {
        // 入参校验，避免空值查库触发异常
        if (role.getName() == null || role.getName().isBlank()) {
            return new ResponseEntity(new ErrorResponse("角色名称不能为空", null),
                    HttpStatus.BAD_REQUEST);
        }
        // 统一做空格裁剪，避免前后空格导致重复值漏检
        String trimmedRoleName = role.getName().trim();
        Role existingRole = roleService.findByName(trimmedRoleName);
        if (existingRole != null) {
            return new ResponseEntity(new ErrorResponse("Role Already Exists ! Please try again..", null),
                    HttpStatus.BAD_REQUEST);
        }
        // 保存前设置统一格式的角色名
        role.setName(trimmedRoleName);
        Role createdRole = roleService.save(role);
        return ResponseEntity.ok(new ApiResponse(true, "Role Saved Successfully", createdRole));
    }
}

代码层的重复检测无法覆盖高并发场景下的竞态条件，需要在数据库层面增加唯一约束兜底：

• 在Role实体的角色名称字段上增加唯一索引注解，确保即使两个并发请求同时通过代码层检测，数据库也会拦截重复值写入：

  // Role实体类中对应角色名称字段的配置
  @Column(unique = true, length = 50)
  private String name;
  

• 如果不想依赖派生查询的方法名规则避免拼写错误，也可以直接手写JPQL实现查询逻辑，解析逻辑更可控：

  // 等价于findByName的自定义实现
  @Query("SELECT r FROM Role r WHERE r.name = :roleName")
  Role queryRoleByName(@Param("roleName") String roleName);
  

内容的提问来源于stack exchange，提问作者Md.Arif Shakil Nobin