SpringMVC/Spring Boot 控制器返回视图路径（相对 / 绝对路径）核心总结

摘要

SpringMVC 中控制器方法返回的字符串会被解析为视图路径，核心区别在于「相对路径」与「绝对路径」：相对路径 会基于当前请求的 URL 层级自动拼接，绝对路径 （以 / 开头）则直接指向项目根路径。这也是为何请求映射成功（方法执行并打印日志），但部分场景仍报 404 的关键原因。
结合 Spring Boot 项目结构（ok.html在resources/static目录下，Spring Boot 默认将static目录映射为项目的静态资源根路径 ，即static/ok.html对应访问路径http://localhost:8080/ok.html）

接下来用两个具体例子对比「相对路径」和「绝对路径」的差异：

例 1：相对路径（会 404 的情况）

假设控制器代码是这样（返回相对路径 "ok.html"）：

java 复制代码

@Controller
public class Demo1Controller {
    // 请求路径：http://localhost:8080/t1/t
    @RequestMapping("/t1/t")
    public String test1() {
        System.out.println("test1方法执行了");
        return "ok.html"; // 相对路径，没有加/
    }
}

此时return "ok.html"是相对路径 ，会基于当前请求的路径/t1/t拼接：解析后的资源访问路径是：http://localhost:8080/t1/ok.html

但 ok.html实际在static目录下（对应访问路径是http://localhost:8080/ok.html），不存在/t1/ok.html这个资源，因路径不匹配所以会报 404。

例 2：绝对路径（成功访问的情况）

就是你现在的代码（返回绝对路径 "/ok.html"）：

java 复制代码

@Controller
public class Demo1Controller {
    // 请求路径：http://localhost:8080/t1/t
    @RequestMapping("/t1/t")
    public String test1() {
        System.out.println("test1方法执行了");
        return "/ok.html"; // 绝对路径，加了/
    }
}

此时return "/ok.html"是绝对路径 ，/代表「项目根路径」，会直接解析为：资源访问路径：http://localhost:8080/ok.html

这个路径正好对应static目录下的ok.html，所以能成功访问。

再举一个更直观的例子

把请求路径改成更层级深的/a/b/c：

java 复制代码

@Controller
public class Demo1Controller {
    // 请求路径：http://localhost:8080/a/b/c
    @RequestMapping("/a/b/c")
    public String test2() {
        // 情况1：返回相对路径"ok.html" → 解析为http://localhost:8080/a/b/ok.html（404）
        // 情况2：返回绝对路径"/ok.html" → 解析为http://localhost:8080/ok.html（成功）
        return "/ok.html";
    }
}

无论你的请求路径层级多深，只要返回加了/的绝对路径 ，都会直接映射到项目根路径下的静态资源（即static目录下的文件）。

总结

控制器返回字符串默认是相对路径，基于当前请求 URL 层级拼接；

以 / 开头为绝对路径，直接映射项目根路径，可避免层级拼接导致的 404；

404 是视图路径解析失败，而非请求映射失败，因此方法仍会执行并打印日志。