如何配置Spring Boot让控制器返回index.html（无需Thymeleaf）

原因分析 #

移除Thymeleaf依赖后，Spring Boot默认不会自动配置InternalResourceViewResolver，你之前配置的spring.mvc.view.prefix/suffix没有对应的视图解析器去生效，导致控制器返回的"index"无法映射到实际的HTML文件。

方案一：手动配置InternalResourceViewResolver #

创建配置类，注册视图解析器Bean，明确指定HTML文件的路径前缀和后缀：

import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.web.servlet.view.InternalResourceViewResolver

@Configuration
class WebMvcConfig {
    @Bean
    fun internalResourceViewResolver(): InternalResourceViewResolver {
        val resolver = InternalResourceViewResolver()
        resolver.setPrefix("/templates/")
        resolver.setSuffix(".html")
        return resolver
    }
}

配置完成后，控制器返回的"index"会被解析为/templates/index.html，和你之前用Thymeleaf时的效果一致。

方案二：改用静态资源映射 + forward跳转 #

1. 将index.html从templates目录移到src/main/resources/static目录下（Spring Boot默认会自动加载该目录下的静态资源）
2. 修改控制器返回forward:/index.html，直接转发到静态资源文件：

@Controller
class ReactAppController {
    @RequestMapping(value = ["/", "/{x:[\\w\\-]+}", "/{x:^(?!api$).*$}/**/{y:[\\w\\-]+}"])
    fun getIndex(): String {
        return "forward:/index.html"
    }
}

这种方式不需要配置视图解析器，更适合纯静态HTML的SPA场景。

方案三：直接返回资源文件 #

修改控制器，直接返回ClassPathResource对象，指定HTML文件的位置：

import org.springframework.core.io.ClassPathResource
import org.springframework.http.MediaType
import org.springframework.web.bind.annotation.RequestMapping
import org.springframework.web.bind.annotation.RestController

@RestController
class ReactAppController {
    @RequestMapping(value = ["/", "/{x:[\\w\\-]+}", "/{x:^(?!api$).*$}/**/{y:[\\w\\-]+}"])
    fun getIndex() = ClassPathResource("templates/index.html").apply {
        contentType = MediaType.TEXT_HTML
    }
}

这种方式绕过视图解析器，直接将HTML文件作为资源返回，适合不需要视图渲染的场景。

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