Spring Boot+Thymeleaf全局配置URL参数编解码方案咨询

嘿，刚好我对Spring Boot + Thymeleaf的URL参数编码解码这块熟得很，给你梳理下解决方案哈～

其实Thymeleaf的@{}URL语法默认就会帮你处理参数的URL编码，不过我们可以通过全局配置确保编码规则统一，避免乱码：

1. 通过配置文件快速统一编码 #

直接在application.properties里添加这些配置，就能全局指定请求、响应和Thymeleaf模板的编码为UTF-8：

# 全局请求响应编码
server.servlet.encoding.charset=UTF-8
server.servlet.encoding.enabled=true
server.servlet.encoding.force=true

# Thymeleaf模板编码
spring.thymeleaf.encoding=UTF-8

2. 规范你的Thymeleaf URL写法 #

你提供的代码片段里，手动拼接URL的方式容易遗漏编码，推荐用Thymeleaf的参数化URL写法，它会自动对参数进行编码：

<!-- 替换你原来的手动拼接写法 -->
<tr th:each="agence : ${listeAgences}">
  <td><input th:type="checkbox" th:name="selected" th:value="${agence?.id}" /></td>
  <td>
    <a class="btn-outline-primary" th:href="@{/admin/Agence/visu(id=${agence?.id})}">查看详情</a>
  </td>
</tr>

<!-- 对应你提到的Historique/stock?devise=EUR场景 -->
<a th:href="@{/Historique/stock(devise=${selectedDevise})}">查看库存历史</a>

这种写法不仅自动编码参数，还更易维护，不用担心特殊字符（比如中文、空格）导致的URL无效问题。

Spring Boot默认会帮你自动完成参数解码，只要全局编码配置一致，直接用@RequestParam就能拿到解码后的参数：

@GetMapping("/Historique/stock")
public String getStockHistorique(@RequestParam("devise") String devise, Model model) {
    // 这里devise已经是解码后的字符串了，比如传入EUR或者带特殊字符的参数都能正确获取
    model.addAttribute("currentDevise", devise);
    // 你的业务逻辑...
    return "historique/stock";
}

如果遇到特殊场景（比如参数是手动编码的，或者需要自定义解码规则），可以手动调用URLDecoder解码：

import java.net.URLDecoder;
import java.nio.charset.StandardCharsets;

@GetMapping("/custom/decode")
public String customDecode(@RequestParam("param") String encodedParam) {
    // 手动指定UTF-8编码解码
    String decodedParam = URLDecoder.decode(encodedParam, StandardCharsets.UTF_8);
    // 后续业务处理...
    return "result";
}

• 保持编码一致性：全局配置、请求、响应、数据库都用同一种编码（推荐UTF-8），从根源避免乱码
• 避免手动拼接URL：尽量用Thymeleaf的@{}或者Spring的UriComponentsBuilder生成URL，减少编码遗漏风险
• POST请求同理：Spring Boot会自动处理POST表单参数的编码，只要配置了server.servlet.encoding相关参数

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