自定义Controller方法导致CrudRepository端点失效如何解决？

当你使用@RestController定义与Spring Data REST自动生成端点同路径的请求映射时，Spring MVC的请求映射处理器会优先匹配自定义Controller中的映射，直接覆盖Spring Data REST生成的同路径端点，这就是导致原有GET、POST/{id}等端点返回405的原因。

方法一：改用@RepositoryRestController（推荐） #

Spring Data REST提供了专门的@RepositoryRestController注解，用于增强自动生成的端点，它不会覆盖原有端点，而是与自动生成的端点共存。只需修改你的Controller注解：

@RepositoryRestController
public class MerchantController {

    private final MerchantService merchantService;

    // Spring 4.3+支持构造器注入自动装配，无需@Autowired
    public MerchantController(MerchantService merchantService) {
        this.merchantService = merchantService;
    }
    
    @PostMapping(path = "/merchants")
    @ResponseStatus(HttpStatus.CREATED)
    public Merchant save(@RequestBody MerchantInputDTO merchantInputDTO) {
        return merchantService.save(merchantInputDTO);
    }

    @PatchMapping(path = "/merchants/{id}")
    @ResponseStatus(HttpStatus.OK)
    public Merchant patch(@RequestBody MerchantInputDTO merchantInputDTO, @PathVariable("id") String id) {
        return merchantService.patch(merchantInputDTO, id);
    }
}

修改后，自定义的POST和PATCH端点会生效，同时Spring Data REST自动生成的GET /merchants、POST /merchants/{id}等端点也能正常访问。

方法二：通过实体字段注解简化需求（无需自定义POST） #

如果你的需求只是创建时排除自动生成的ID字段，完全不需要自定义POST方法。可以直接在Merchant实体的ID字段上添加注解，控制序列化/反序列化行为：

public class Merchant {
    @Id
    // 允许查询时返回ID，但创建时忽略该字段
    @JsonIgnore(allowGetters = true)
    private String id;
    
    // 其他业务字段
}

这样Spring Data REST自动生成的POST /merchants就能直接接收不带ID的请求体，同时保留所有自动生成的端点，无需额外编写Controller。

方法三：给自定义Controller设置独立路径 #

如果不需要和自动生成端点同路径，可以给自定义Controller添加基础路径，避免冲突：

@RestController
@RequestMapping("/custom-merchants")
public class MerchantController {
    // ... 原有方法，路径改为/custom-merchants/xxx
}

这种方式简单直接，但会改变接口路径，适合允许调整接口地址的场景。

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