创建Actuator端点时遇DataValidationException及资源未找到错误的原因

咱们一步一步拆解这个问题的可能原因，毕竟你同时碰到了NOT_FOUND响应、Spring Data Rest抛出的ResourceNotFoundException，还有端点创建时触发的DataValidationException：

• Actuator端点未正确暴露或启用
  虽然你在endpoints.yml里配置了Actuator，但可能遗漏了关键的暴露配置：

  • 没有设置management.endpoints.web.exposure.include来指定要对外暴露的端点（比如health、info或者用*暴露所有端点）。如果只定义了端点但不暴露，请求时自然会返回404。
  • 检查management.endpoints.enabled-by-default是否被设为false，如果是，你需要手动开启特定端点（比如management.endpoint.health.enabled=true），否则端点根本不会初始化。

• Spring Data Rest与Actuator的路径冲突
  控制台里的ResourceNotFoundException来自Spring Data Rest，这说明请求的路径被Spring Data Rest接管了，而非路由到Actuator端点：

  • 比如你的Actuator基础路径（management.server.base-path）和Spring Data Rest的根路径重合（比如都设为/api），此时请求Actuator端点会被Spring Data Rest当成要查找的实体资源，进而抛出“资源未找到”的异常。
  • 建议给Actuator设置独立的基础路径，比如management.server.base-path=/actuator，避免和业务接口路径冲突。

• 端点初始化时的校验失败（DataValidationException）
  这个异常直接说明在创建Actuator端点的过程中，某部分配置或关联资源未通过校验：

  • 如果你自定义了Actuator扩展端点，检查端点配置类是否存在必填属性未设置、属性格式错误等问题（比如继承AbstractEndpoint的类未正确配置ID或描述）。
  • 关联的Spring Bean（比如端点依赖的Repository、Service）可能存在数据校验问题：比如实体类的JSR-380校验注解（@NotNull、@Size等）在初始化时触发了校验失败，或者配置的参数不符合规则。
  • 一定要查看DataValidationException的完整堆栈信息，里面会明确指出校验失败的字段和原因，这是最快定位问题的方式。

• 安全框架拦截了Actuator请求
  如果项目中使用了Spring Security或其他安全组件，可能拦截了对Actuator端点的访问，导致请求被拒绝后返回404（部分配置下会伪装成404而非403）：

  • 检查安全配置类，确认是否为Actuator端点添加了放行规则，比如：

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            .antMatchers("/actuator/**").permitAll() // 根据需求配置权限，比如允许认证用户访问
            .anyRequest().authenticated();
    }
    

• 端点路径配置或请求拼写错误
  最后确认请求路径和配置是否匹配：

  • 如果设置了management.server.base-path，比如/manage，那么正确的端点路径应该是/manage/health，而非默认的/actuator/health。
  • 检查endpoints.yml的语法是否正确，比如缩进错误、属性名拼写错误（比如把exposure写成expose），这些都会导致配置不生效。

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