React与Spring Boot接口路径交互渲染异常问题求助

案例1：直接访问API路径无React内容 #

• 访问localhost:8080时，因为没有匹配的Spring控制器，Spring会返回React打包后的入口index.html（前提是你已经把React构建文件放到Spring的static/public静态资源目录），加载后React能正常渲染并通过前端请求调用/api/v1/hello获取数据展示。
• 但直接访问/api/v1/hello时，这个路径刚好匹配你定义的Spring控制器方法，Spring会直接返回控制器生成的字符串响应，完全不会返回React的index.html，所以看不到任何React内容。核心是Spring控制器路由优先级高于静态资源路由，只要路径命中控制器，就不走静态资源流程。

案例2：根路径加控制器后React无法渲染 #

• 给根路径/新增控制器后，访问localhost:8080时，Spring会优先匹配这个根路径的控制器方法，直接返回“Start page”字符串，跳过了返回React入口index.html的逻辑。前端连入口页都加载不到，自然无法渲染任何React内容。

案例3：同时保留两个控制器时React完全失效 #

• 根路径/和/api/v1/hello都被Spring控制器占用，访问这两个路径时，Spring都会直接返回控制器的响应内容，完全不会触发静态资源的index.html返回。前端没有加载入口页的机会，所以React完全无法渲染。

核心本质 #

Spring MVC的路由匹配优先级规则是：控制器方法映射 > 静态资源映射。只要请求路径能匹配到已定义的控制器，就会直接返回控制器的响应，只有当没有匹配的控制器时，才会去查找静态资源（比如React的index.html）。你的所有问题都是因为控制器路径和前端所需的静态资源路径（根路径）或前端直接访问的路径发生了冲突，导致React入口页无法被加载。

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