Spring Boot微服务GET接口报错500：ChangeSetPersister$NotFoundException求助

嗨，我帮你分析了代码和报错信息，这个500错误的直接原因很明确，咱们一步步来解决：

1. 直接触发错误的原因：路径变量大小写不匹配 #

看你的控制器代码：

• 请求路径定义的是 /cerca/{registration_number}（全小写的registration_number）
• 但@PathVariable的参数名写的是registration_Number（驼峰式，N大写）

Spring MVC对路径变量的大小写是敏感的，这就导致当你调用/user/cerca/ciao时，registrationNumber参数会被注入为null。接着userService.SelByRegistrationNumber(null)返回null，触发了你写的throw new ChangeSetPersister.NotFoundException()代码，最终返回500错误。

修复方法：
把@PathVariable的参数名和路径里的变量名统一，两种方式任选一种：

// 方式1：参数名和路径变量名完全一致
@GetMapping(value = "/cerca/{registration_number}", produces = "application/json")
public ResponseEntity<UserDto> listUserByRegistrationNumber(@PathVariable("registration_number") String registrationNumber) throws ChangeSetPersister.NotFoundException {
    // ... 原有逻辑
}

// 方式2：保持参数驼峰风格，用value指定路径变量名
@GetMapping(value = "/cerca/{registration_number}", produces = "application/json")
public ResponseEntity<UserDto> listUserByRegistrationNumber(@PathVariable(value = "registration_number") String registrationNumber) throws ChangeSetPersister.NotFoundException {
    // ... 原有逻辑
}

2. 优化点：将异常转为友好的404响应 #

你抛出的ChangeSetPersister.NotFoundException是Spring Data的内部异常，Spring MVC默认会把它当作服务器内部错误返回500，但实际上这是“资源不存在”的场景，应该返回404才更合理。

优化方案：

• 自定义业务异常：

public class UserNotFoundException extends RuntimeException {
    public UserNotFoundException(String message) {
        super(message);
    }
}

• 在控制器里替换原有异常：

if (user == null) {
    String ErrMsg = String.format("L'user con numeroRegistrazione %s non è stato trovato!", registrationNumber);
    log.warning(ErrMsg);
    // 替换为自定义异常
    throw new UserNotFoundException(ErrMsg);
}

• 添加全局异常处理器，返回404和提示信息：

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(UserNotFoundException.class)
    public ResponseEntity<String> handleUserNotFound(UserNotFoundException ex) {
        return new ResponseEntity<>(ex.getMessage(), HttpStatus.NOT_FOUND);
    }
}

3. 潜在问题排查：DTO序列化时的懒加载风险 #

你的UserDto里直接引用了多个懒加载的实体类（比如Role、Company），当Spring MVC序列化UserDto返回给客户端时，这些关联对象可能还没被初始化，会抛出LazyInitializationException。

建议解决方法：

• 给关联对象也创建对应的DTO（比如RoleDto、CompanyDto），在UserDto里使用这些DTO而非实体类
• 或者在查询用户时，通过fetch join提前初始化关联对象，修改Repository方法：

@Query("SELECT u FROM User u LEFT JOIN FETCH u.applicationRoleID LEFT JOIN FETCH u.companyID WHERE u.registrationNumber = :registrationNumber")
User findByRegistrationNumber(@Param("registrationNumber") String registrationNumber);

4. 额外验证：Repository方法的有效性 #

确认UserRepository中的findByRegistrationNumber方法能正确匹配数据库字段：你的实体类已经用@Column(name = "registration_number")指定了数据库列名，Spring Data的自动查询方法会正确映射，这点没问题，但可以测试传入正确的registrationNumber值，确认能查到数据。

先修复第一个路径变量的问题，就能解决当前的500错误了，后面的优化点可以提升接口的健壮性和用户体验。

内容的提问来源于stack exchange，提问作者Michele Raso