Spring Boot2.7.5+Angular15打包WAR后刷新页面404及循环路径问题求助

问题根源 #

SPA（单页应用）的前端路由在浏览器刷新时，会直接向后端发起对应路径的HTTP请求，但Spring Boot默认会把这些路径当作API端点去查找对应的Java控制器方法，找不到就返回404。你之前尝试的控制器出现循环视图错误，是因为没有正确指定转发到静态资源的路径，导致请求被重复拦截。

方案1：编写转发控制器（简单直接） #

创建一个普通@Controller（不要用@RestController），拦截所有前端路由路径，转发到index.html：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class SpaForwardController {

    // 拦截所有以/fe开头的GET请求（匹配你的前端路由前缀）
    @RequestMapping(value = "/fe/**", method = RequestMethod.GET)
    public String forwardToIndex() {
        // 使用forward直接转发到静态资源目录下的index.html，避免视图解析器循环
        return "forward:/index.html";
    }
}

关键说明： #

• 不要用@RestController：@RestController会把返回值当作JSON/文本直接返回，而不是视图转发。
• 使用forward:/index.html：明确告诉Spring Boot直接转发到静态资源，而不是通过视图解析器查找视图，避免循环错误。
• 路径匹配/fe/**：只拦截你的前端路由路径，不会影响API接口（假设你的API路径是/api/**之类的非/fe前缀），同时Spring Boot会优先处理静态资源请求（比如/fe/assets/*.js这类文件），不会被控制器拦截。

方案2：配置WebMvcConfigurer（更灵活） #

如果需要更精细的资源控制，实现WebMvcConfigurer接口来配置路由转发和静态资源：

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

@Configuration
public class SpaWebConfig implements WebMvcConfigurer {

    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        // 转发所有/fe开头的GET请求到index.html
        registry.addViewController("/fe/**")
                .setViewName("forward:/index.html");
        // 根路径直接指向index.html
        registry.addViewController("/").setViewName("forward:/index.html");
    }

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 配置静态资源优先级，确保静态文件（js/css/img等）优先被处理
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/static/")
                .setCachePeriod(0); // 开发环境禁用缓存，生产环境可调整为3600等
    }
}

配套Angular配置 #

确保Angular构建时设置正确的base-href，因为你的静态资源放在Spring Boot的static目录下（对应根路径/）：

• 构建时执行：ng build --base-href="/"
• 或者在angular.json中配置：

  "projects": {
    "your-angular-project": {
      "architect": {
        "build": {
          "options": {
            "baseHref": "/",
            // 其他配置...
          }
        }
      }
    }
  }
  

验证步骤 #

1. 重新构建Angular项目，确保产物复制到backend/src/main/resources/static目录。
2. 构建Spring Boot WAR包并部署到Tomcat。
3. 访问http://localhost:8080登录后跳转到/fe/appInstances，刷新页面，此时Spring Boot会将请求转发到index.html，Angular会接管路由并渲染正确页面。

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