如何让Spring Data REST对无效端点返回4xx错误码？

哈哈，这个问题确实挺坑的——我之前也碰到过类似的情况，明明发错了端点却收到204，差点造成线上问题。咱们分两部分来解决：

默认情况下，Spring Data REST对完全不存在的端点（比如/api/nonexistent）其实会返回404，但如果是那种看似匹配关联路径但实际无效的端点（比如你提到的/api/school/student），可能因为模糊匹配或者关联暴露的问题返回了204。咱们先把基础配置调对：

第一步：开启严格路径匹配 #

在application.properties（或application.yml）里加一行：

spring.mvc.pathmatch.matching-strategy=PATH_PATTERN_PARSER

这个配置会让Spring MVC用更严格的规则匹配路径，不会把类似/api/school.json这种带后缀的请求当成/api/school，也不会忽略末尾的斜杠差异。

第二步：控制资源暴露范围 #

自定义一个RepositoryRestConfigurer，只暴露你需要的关联资源，从根源上减少无效端点：

import org.springframework.context.annotation.Configuration;
import org.springframework.data.rest.core.config.RepositoryRestConfiguration;
import org.springframework.data.rest.webmvc.config.RepositoryRestConfigurer;
import org.springframework.web.servlet.config.annotation.PathMatchConfigurer;

@Configuration
public class CustomRestConfig implements RepositoryRestConfigurer {

    @Override
    public void configureRepositoryRestConfiguration(RepositoryRestConfiguration config) {
        // 只暴露需要的实体ID，可选但推荐
        config.exposeIdsFor(Student.class, School.class);
        // 让创建/更新操作返回实体内容，方便验证结果
        config.setReturnBodyOnCreate(true);
        config.setReturnBodyOnUpdate(true);
    }

    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        // 禁用后缀匹配和末尾斜杠忽略，进一步强化路径匹配严格性
        configurer.setUseSuffixPatternMatch(false);
        configurer.setUseTrailingSlashMatch(false);
    }
}

核心痛点是：当你往非关联拥有方的端点发DELETE请求时（比如/api/school/{id}/student，但Student才是关联拥有方），Spring Data REST没做任何操作却返回204，让你误以为成功。这里有几个方案：

方案一：直接隐藏无效的关联端点 #

在非拥有方的实体类里，用@JsonIgnore把关联字段藏起来，这样Spring Data REST就不会生成对应的端点了：
比如在School类中：

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

    // 非拥有方关联，用@JsonIgnore阻止REST暴露该端点
    @OneToMany(mappedBy = "school", fetch = FetchType.LAZY)
    @JsonIgnore
    private List<Student> students;

    // getter/setter...
}

这样/api/school/{id}/student这个端点直接不存在，访问时会返回404，从根源上避免误操作。

方案二：拦截无效请求返回4xx错误 #

如果不想隐藏端点，而是想明确告诉客户端“这个操作不允许”，可以自定义一个拦截器：
先写拦截器类：

import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@Component
public class AssociationValidationInterceptor extends HandlerInterceptorAdapter {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws IOException {
        String method = request.getMethod();
        String uri = request.getRequestURI();

        // 匹配到往School的student关联发DELETE请求的场景
        if ("DELETE".equals(method) && uri.matches("/api/school/\\d+/student")) {
            response.setStatus(HttpStatus.METHOD_NOT_ALLOWED.value());
            response.getWriter().write("错误：无法通过School端点修改Student关联，请使用 /api/student/{id}/school");
            return false;
        }
        return true;
    }
}

然后注册拦截器：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    private final AssociationValidationInterceptor validationInterceptor;

    public WebConfig(AssociationValidationInterceptor validationInterceptor) {
        this.validationInterceptor = validationInterceptor;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(validationInterceptor)
                .addPathPatterns("/api/**");
    }
}

这样误发请求时会返回405（方法不允许），还能给出明确的提示信息。

方案三：覆盖默认的关联控制器 #

如果你需要更灵活的处理，可以用RepositoryRestController覆盖默认的关联处理逻辑：

import org.springframework.data.rest.webmvc.RepositoryRestController;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.PathVariable;

@RepositoryRestController
public class CustomAssociationController {

    // 覆盖School的student关联DELETE请求
    @DeleteMapping("/school/{schoolId}/student")
    public ResponseEntity<Void> deleteSchoolStudentAssociation(@PathVariable Long schoolId) {
        // 直接返回405，明确表示该操作不被允许
        return ResponseEntity.status(HttpStatus.METHOD_NOT_ALLOWED).build();
    }
}

总结 #

• 无效端点问题：通过严格路径匹配+控制资源暴露，确保返回404
• 错发关联请求问题：要么隐藏无效端点返回404，要么拦截请求返回405，选最适合你业务场景的方式就行

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