Spring Boot+Thymeleaf表单UTF-8编码乱码问题求助

以下是针对该编码问题的分步排查与解决方案：

1. 检查数据库连接与存储编码（最常见根源） #

大部分特殊字符乱码问题出在数据库存储环节，需确保数据库连接、表及字段均使用UTF-8（推荐utf8mb4，支持更全Unicode字符）：

配置数据库连接编码 #

在application.properties中补充数据库URL的编码参数（以MySQL为例）：

spring.datasource.url=jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=UTC

确认数据库表/字段字符集 #

确保Post对应的数据库表及title、content字段的字符集设置为utf8mb4，排序规则可选择utf8mb4_unicode_ci或utf8mb4_general_ci。

2. 完善Spring Boot全局编码配置 #

在现有编码配置基础上，补充强制请求/响应编码的参数，覆盖所有场景：

server.servlet.encoding.charset=UTF-8
server.servlet.encoding.enabled=true
server.servlet.encoding.force=true
server.servlet.encoding.force-request=true
server.servlet.encoding.force-response=true

spring.http.encoding.charset=UTF-8
spring.http.encoding.enabled=true
spring.http.encoding.force=true

spring.thymeleaf.encoding=UTF-8

3. 确保Thymeleaf模板编码正确 #

• 检查.html模板文件本身的保存编码为UTF-8（如IDEA中需在File Encodings设置中统一配置项目编码为UTF-8）
• 在模板的<head>标签中显式声明编码：

<meta charset="UTF-8">

4. 验证请求接收阶段的编码 #

在createPost方法中添加调试代码，确认请求编码及接收的参数是否正常：

@PostMapping("/post/create")
public String createPost(@ModelAttribute @Valid PostDto postDto,
                         BindingResult bindingResult,
                         Model model,
                         HttpServletRequest request) {
    // 打印请求编码与接收的参数
    System.out.println("请求编码：" + request.getCharacterEncoding());
    System.out.println("接收的标题：" + postDto.getTitle());
    System.out.println("接收的内容：" + postDto.getContent());
    
    // 原有业务逻辑...
}

如果输出中请求编码不是UTF-8，需手动注册优先级最高的编码过滤器：

@Configuration
public class WebConfig {
    @Bean
    public FilterRegistrationBean<CharacterEncodingFilter> characterEncodingFilter() {
        CharacterEncodingFilter filter = new CharacterEncodingFilter();
        filter.setEncoding("UTF-8");
        filter.setForceEncoding(true);
        FilterRegistrationBean<CharacterEncodingFilter> registrationBean = new FilterRegistrationBean<>(filter);
        registrationBean.setOrder(Ordered.HIGHEST_PRECEDENCE); // 确保过滤器优先级最高
        return registrationBean;
    }
}

5. 检查日志输出编码 #

如果数据库存储正常但日志显示问号，需配置日志框架使用UTF-8编码（以Logback为例，在logback.xml中修改控制台输出编码器）：

<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <charset>UTF-8</charset>
        <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
</appender>

6. 明确Post实体类字段编码注解 #

在Post实体类的文本字段上显式指定字符集，避免数据库默认配置干扰：

@Entity
public class Post {
    // 其他字段...
    
    @Column(columnDefinition = "VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci")
    private String title;
    
    @Lob
    @Column(columnDefinition = "TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci")
    private String content;
    
    // getter/setter...
}

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