SpringMVC Controller 层没有使用 @ResponseBody 注解引发的血案（api访问404）

问题现象：

项目组的一个同事发现在请求该接口时候，总是报 404 错误，又找不到错误日志，一时之间不知道该如何去着手解决问题，我帮他排查问题的时候，发现该接口两次经过拦截器的 preHandle 方法，并且通过 debug 断点调试发现，两次请求的路径不一样，这一下我也不知道该如何解决该问题了，现象如下：

现象复现测试代码，非原代码（原代码不宜公开）：

@Controller
@RequestMapping("/api")
public class TestController {

    @ApiOperation(httpMethod = "GET", value = "注销登录", notes = "注销登录")
    public String testController() {
        return "成功";
    }

}

测试结果：

{
    "timestamp": "2024-04-19T11:34:02.499+00:00",
    "status": 404,
    "error": "Not Found",
    "message": "",
    "path": "/api/test-controller"
}

测试过程，debugger 情况展示：

在这里插入图片描述
很明显两次请求的路径不一样，第一次请求的路径是我们正常的路径：”/api/test-controller“，第二次请求的路径正是：“/api/成功”，很明显问题就出在第二请求路径上，代码中不存在这个请求路径，肯定要报错：404，为什么会有第二次请求呢？

原因分析：

第二次请求肯定不是我们自己请求的，那必然是程序自己触发的，也就是 SpingMVC 自己发起的，还是老办法使用 debugg 调试，在进行 debugger 调试跟踪源码的时候，发现第一次请求把返回值封装成了 ModelAndView 对象，等于返回值成了一个待跳转的页面，至此就很好理解 404 错误了。

在这里插入图片描述

找到原因了就很好解决问题了，导致这个问题的根源就是没有使用 @ResponseBody，因为习惯了使用 @RestController 注解，想着控制层Controller 代码很简单，应该不会出这个问题，同事可能也是复制之前的代码，一是没有注意导致了这个问题的发生。

@RestController 相当于 @Controller + @ResponseBody 注解，源码如下：

package org.springframework.web.bind.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import org.springframework.core.annotation.AliasFor;
import org.springframework.stereotype.Controller;

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Controller
@ResponseBody
public @interface RestController {
    @AliasFor(
        annotation = Controller.class
    )
    String value() default "";
}