Spring Boot配置Thymeleaf无控制器处理国际化HTML页面

嘿，我来帮你搞定这个问题！你现在用的临时控制器方案其实完全没必要，Spring Boot本身就支持通过简单配置让Thymeleaf直接处理你放在/src/main/resources/html下的页面，还能完美结合国际化功能，一步步来：

• 第一步：确认Thymeleaf依赖已正确引入
  如果是Maven项目，检查pom.xml里是否已经加入Spring Boot Thymeleaf starter依赖：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-thymeleaf</artifactId>
  </dependency>
  

  Gradle项目的话，在build.gradle里添加：

  implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
  

• 第二步：配置Thymeleaf路径与国际化参数
  在application.properties（或application.yml）里添加以下配置，指定Thymeleaf的模板根目录、文件后缀，以及国际化消息文件的相关设置：

  # Thymeleaf模板核心配置
  spring.thymeleaf.prefix=classpath:/html/
  spring.thymeleaf.suffix=.html
  spring.thymeleaf.mode=HTML
  spring.thymeleaf.encoding=UTF-8
  
  # 国际化消息配置
  spring.messages.basename=messages
  spring.messages.encoding=UTF-8
  spring.messages.cache-duration=3600s # 可选，设置消息缓存时长提升性能
  

  这里的spring.messages.basename=messages表示你的国际化文件是messages.properties（默认语言）、messages_zh_CN.properties、messages_en_US.properties等，直接放在/src/main/resources目录下即可。

• 第三步：移除临时控制器
  删掉你写的那个带有@RequestMapping(value="**/*.html")的控制器——配置完成后，Spring Boot会自动将/some/path/test.html这样的请求映射到/src/main/resources/html/some/path/test.html页面，由Thymeleaf自动解析处理，完全不需要手动写路由。

• 第四步：在Thymeleaf页面中使用国际化
  在你的HTML页面里，首先要引入Thymeleaf的命名空间，然后用#{key}语法调用国际化消息：

  <!DOCTYPE html>
  <html xmlns:th="http://www.thymeleaf.org">
  <head>
      <meta charset="UTF-8">
      <title th:text="#{page.title}"></title>
  </head>
  <body>
      <h1 th:text="#{welcome.greeting}"></h1>
      <p th:text="#{welcome.desc}"></p>
  </body>
  </html>
  

  比如在messages_zh_CN.properties里可以写：

  page.title=测试页面
  welcome.greeting=欢迎访问！
  welcome.desc=这是一个基于Thymeleaf的国际化页面
  

• 第五步：测试访问
  启动Spring Boot应用后，直接访问http://localhost:8080/some/path/test.html就能看到渲染后的国际化页面。如果需要切换语言，只需要在请求里加lang参数，比如http://localhost:8080/some/path/test.html?lang=en_US，Spring Boot会自动加载对应的英文消息文件。

这样配置后，不仅能摆脱临时控制器的繁琐，还能充分利用Thymeleaf的模板缓存、布局复用等特性，让国际化功能更优雅地运行。

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