SpringBoot创建Web项目访问静态资源中文乱码问题

最新推荐文章于 2025-05-22 00:39:42 发布

吖soul

最新推荐文章于 2025-05-22 00:39:42 发布

阅读量2.5k

点赞数 1

CC 4.0 BY-SA版权

文章标签： java spring boot

本文链接：https://blog.csdn.net/u014018797/article/details/107739785

本文介绍了在Spring Boot项目中遇到的静态资源中文乱码问题及其解决方案。通过在application.yaml配置文件中添加特定配置，可以解决浏览器访问静态资源时中文显示为乱码的问题。该配置涉及HTTP请求和响应的字符集转换，启用编码过滤器以确保正确显示中文内容。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

今天在使用 Spring Boot 创建的一个 Web 项目中遇到了一个小问题，浏览器访问静态资源如 test.txt 时，中文变为乱码，如图：
静态资源出现中文乱码

解决方法是：在Spring Boot 的全局配置文件比如 application.yaml 中添加以下配置：

# 解决静态资源中文乱码问题！
server:
  servlet:
    encoding:
      force: true

添加这条之后重启应用，再尝试访问中文静态资源：
显示正常

这一条配置有何作用呢？

最低0.47元/天解锁文章

200万优质内容无限畅学

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

吖soul

关注关注

1
点赞
踩
3

收藏

觉得还不错? 一键收藏
1
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

springboot + thymeleaf静态资源访问404

weixin_30687587的博客

09-13

2173

在使用springboot 和thtmeleaf开发时引用静态资源404，静态资源结如下： index.html文件： <!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta charset = "UFT-8" /&gt...

SpringBoot整合web项目详细过程

weixin_44339576的博客

11-27

1834

最近开始跟着学SpringBoot，记录一下SpringBoot实现简单网站的CRUD，以便日后回顾。准备工作首先导入现有模板静态资源（可以网上找免费的）：一般静态资源放在根目录下的static文件夹下。 html文件放在template文件夹下，这里包括：登录页面index.html, 首页dashboard.html, 错误页面404.html, 员工管理页面list.html。项目目录截图编写java类（使用lombok插件） Empoyee package com.fanjh.po

1 条评论您还未登录，请先登录后发表或查看评论

SpringBoot访问静态资源中文乱码

qq_40226073的博客

06-15

2214

SpringBoot的静态资源位置如下几个： /META-INF/resources/ classpath:/resources/ classpath:/static/ classpath:/public/ 优先级从上之下逐渐降低。访问其中的资源文件可能会出中文乱码：解决方式：在application.properties中加上： server.servlet.encoding.force=true 即可解决 ...

application field to start 问题

09-26

364

打包后没有 .properties 文件,导致启动失败. <build> <plugins> <plugin> <groupId>org.springframewor...

spring/springboot如何解决中文乱码问题

最新发布

fqlya的博客

05-22

839

解决位置方法或配置配置开启 UTF-8 编码Spring MVC 手动配置使用过滤器（XML 或 Java Config）Tomcat前端请求设置设置以及请求头 Content-Type。

java web乱码_Springboot 系列（五）web 开发之静态资源和模版引擎

weixin_39803022的博客

11-26

134

文章已经收录在 github:niumoo/JavaNotes ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。前言Spring Boot 天生的适合 web 应用开发，它可以快速的嵌入 Tomcat, Jetty 或 Netty 用于包含一个 HTTP 服务器。且开发十分简单，只需要引入 web 开发所需的包，然后编写业务代码即可。自动配置原理？在进行 web 开发之前让我再来...

SpringBoot 静态文件中文乱码解决方法

咸鱼的博客

04-09

4064

<%@ page language="java" contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %> 如果搜过网上其他方法没用后把这个加到静态文件开头上试试也许有惊喜

springboot static下页面中文乱码

haoranhaoshi的博客

04-01

1245

误以为： package com.program.face.config; import com.fasterxml.jackson.databind.ObjectMapper; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configurat...

Spring boot web 访问

05-08

总结来说，"Spring Boot web 访问"涵盖了创建一个基础的Spring Boot Web应用，配置访问静态资源，使用Spring Boot DevTools进行快速开发，以及处理中文乱码问题。这些都是Spring Boot入门开发者需要掌握的基本技能，...

springboot中文参考指南

10-29

- **静态资源处理**：默认情况下，SpringBoot会处理`/static/`、`/public/`、`/resources/`目录下的静态资源。 5. **数据访问** - **JPA与Hibernate**：SpringBoot支持JPA规范，通过`@Entity`、`@Repository`等...

spring boot 静态文件中中文乱码问题解决

white_ice的博客

08-23

8760

访问 spring boot 项目中静态文件静态页面时中文乱码，解决方法是在properties文件中增加配置： spring.http.encoding.force=true

springboot之访问静态资源十五

just love code

05-16

282

springboot项目中的静态资源都存储在static文件夹下：访问路径：localhost:8080/Younger.jpg

springMVC客户端请求中文乱码以及静态资源访问问题的解决

贪吃小明的博客

05-23

1104

客户端请求乱码原理是创建一个过滤器过滤所有的请求，看看每个请求中的编码方式是否为指定编码方式代码实现：创建一个解决乱码的过滤器package com.imooc.oa.global; import javax.servlet.*; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpSer...

SpringBoot + shiro 导致通过ResourceHandlerRegistry配置的静态资源中文名称无法访问原因

每天进步一点就够了

12-25

2838

项目场景：项目使用的springboot+shiro，出于其他原因考量，静态资源是直接使用的springboot 框架本身的ResourceHandlerRegistry来进行配置访问的，没有使用Nginx，Apache等问题描述：项目中的一些静态资源是通过配置ResourceHandlerRegistry来进行访问的，即通过复写WebMvcConfigurer，列如： @Slf4j @Configuration public class WebConfig implements WebMvcCo

springboot-项目获取resources下文件乱码

qq_42043982的博客

10-18

2462

SpringBoot读取resource目录文件

IDEA的Springboot下url乱码问题java.lang.IllegalArgumentException

li___xiansheng的博客

07-01

410

高版本tomcat中的新特性：就是严格按照 RFC 3986规范进行访问解析，RFC3986 规范定义Url中只允许英文，数字，特殊字符。否则接收会出现乱码，中文参数报错情况启动类中添加@Bean webServerFactory 方法 ...

SpringMVC-中文乱码问题与静态资源（CSS，js，images）无法访问问题

Dev_Hugh的博客

06-11

974

一、中文乱码问题 1.1、web.xml文档的配置 Spring框架给我们提供过滤器CharacterEncodingFilter 这个过滤器就是针对于每次浏览器请求进行过滤的，然后再其之上添加了父类没有的功能即处理字符编码。其中encoding用来设置编码格式，forceEncoding用来设置是否理会 request.getCharacterEncoding()方法，设置为true则强制覆盖之前的编码格式在web.xml中配置的初始页面是不会进入过滤器的，结果就是导致访问初始页面时出现中文乱码

SpringMVC--静态资源加载和中文乱码处理

qq_39188134的博客

08-26

666

SpringMVC静态资源加载原先配置的dispatcher拦截了所有请求，所以访问静态资源会失败！！ <servlet> <servlet-name>DispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-p

Springboot项目请求乱码问题

怪咖@的博客

09-02

2138

刚开始一直以为是浏览器问题，因为使用postman也是返回的中文。并没有乱码问题，于是搜了很多关于谷歌浏览器乱码问题的。谷歌浏览器本身设置当中好像是没有设置编码的地方，于是下载了一个插件，专门用于修改浏览器的编码。请求乱码，但是看F12当中的请求又并没有乱码，这就很莫名其妙了。最终添加如下配置修改响应编码，成功解决！

springboot html乱码

03-28

<think>好的，我现在要解决用户的问题：SpringBoot项目中HTML页面出现乱码的情况。用户希望得到解决方案，特别是关于编码问题的处理。首先，我需要回忆一下SpringBoot中文乱码的常见原因和解决方法，并结合用户提供的引用内容进行分析。根据用户提供的引用[1]，提到Spring Boot没有传统的web.xml配置，解决中文乱码可以通过几种方式，比如设置字符编码过滤器。这可能涉及到配置Spring的HttpMessageConverter或者设置响应头中的Content-Type。另外引用[2]提到Redis存储数据时的乱码问题，虽然和HTML页面乱码不完全相关，但可能提示了序列化设置或默认编码的问题，不过这可能更多涉及后端数据存储，暂时先不考虑。首先，HTML页面乱码通常是因为服务器返回的响应头中没有正确指定字符编码，或者HTML文件本身的编码与实际声明的不一致。比如，HTML的meta标签中声明了UTF-8，但实际文件保存为其他编码，或者服务器响应的Content-Type头没有charset参数。接下来，我需要考虑在Spring Boot中如何确保响应的内容使用UTF-8编码。可能的解决步骤包括： 1. 检查HTML文件的编码是否一致：确保HTML文件保存为UTF-8格式，并且meta标签中有`<meta charset="UTF-8">`。如果文件编码是GBK或其他，可能导致浏览器解析错误。 2. 配置Spring Boot的HttpMessageConverters，特别是StringHttpMessageConverter的默认编码设为UTF-8。因为Spring Boot默认可能使用ISO-8859-1，这会导致返回的文本（如Thymeleaf模板、静态HTML）出现乱码。 3. 在application.properties或application.yml中设置相关属性，比如server.servlet.encoding.charset=UTF-8和enabled=true，强制服务器使用UTF-8编码处理请求和响应。 4. 检查是否使用了模板引擎（如Thymeleaf、FreeMarker），并确保模板引擎的编码配置正确。例如，Thymeleaf可以通过配置spring.thymeleaf.encoding=UTF-8。 5. 检查是否有过滤器或拦截器修改了响应头，导致Content-Type被覆盖。可能需要添加一个过滤器来设置响应头的字符集。根据引用[1]中的解决方案，可能需要手动配置字符编码过滤器，类似传统的web.xml中配置CharacterEncodingFilter。在Spring Boot中可以通过配置类来添加这个过滤器。另外，检查静态资源的处理，是否因为某些配置导致静态HTML文件的Content-Type没有被正确识别，比如某些MIME类型配置错误。可能的错误点：如果用户返回的是通过@RestController或@ResponseBody返回的JSON数据，则可能需要配置Spring的消息转换器，但如果是HTML页面，则问题可能出在模板引擎或静态资源的处理上。总结可能的解决方案步骤： - 确认HTML文件编码和meta标签一致。 - 配置Spring Boot的HTTP编码设置。 - 配置模板引擎的编码（如果使用的话）。 - 添加CharacterEncodingFilter确保请求和响应的编码正确。 - 检查响应头中的Content-Type是否包含charset=UTF-8。现在需要将这些步骤具体化，并参考用户提供的引用内容，特别是引用[1]提到的解决方案，如配置过滤器或消息转换器。同时，注意用户提到的是HTML页面乱码，可能涉及静态资源，而Thymeleaf等模板引擎渲染的情况也可能需要处理。可能的代码示例包括在application.properties中设置server.servlet.encoding.charset=UTF-8，或者创建配置类添加StringHttpMessageConverter的Bean，设置其默认编码为UTF-8。此外，如果用户使用的是JSP，可能需要配置视图解析器的编码，但Spring Boot默认不推荐JSP，可能使用的是Thymeleaf或其他模板引擎。例如，针对Thymeleaf，可以在application.properties中设置： spring.thymeleaf.encoding=UTF-8 spring.thymeleaf.servlet.content-type=text/html 这样确保模板引擎处理时使用正确的编码。如果用户返回的是纯HTML静态文件，可能需要配置资源处理，例如通过WebMvcConfigurer设置默认Servlet的编码，或者确保容器（如Tomcat）的URI编码设置为UTF-8。此外，检查HTTP响应头是否正确，如使用开发者工具查看响应头中的Content-Type是否为text/html;charset=UTF-8。如果不是，可能需要强制设置响应头。最后，可能需要测试不同的场景，比如直接访问静态HTML文件，或通过控制器返回的视图，分别处理。</think>在Spring Boot项目中解决HTML页面乱码问题，需从文件编码、服务器配置、模板引擎设置等多方面入手。以下是分步解决方案： ### 1. 检查HTML文件编码及Meta标签 - **确保HTML文件保存为UTF-8编码**：在IDE（如IntelliJ或VSCode）中，检查文件编码设置，避免使用GBK等编码。 - **添加Meta标签**：在HTML的`<head>`中明确声明UTF-8： ```html <meta charset="UTF-8"> ``` ### 2. 配置Spring Boot全局编码在`application.properties`中设置请求和响应的默认编码： ```properties # 强制使用UTF-8编码处理请求和响应 server.servlet.encoding.charset=UTF-8 server.servlet.encoding.enabled=true server.servlet.encoding.force=true ``` ### 3. 配置消息转换器（针对@ResponseBody或API）若返回JSON或通过`@RestController`处理数据，需配置`StringHttpMessageConverter`： ```java @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void configureMessageConverters(List<HttpMessageConverter<?>> converters) { StringHttpMessageConverter converter = new StringHttpMessageConverter(StandardCharsets.UTF_8); converters.add(converter); } } ``` ### 4. 模板引擎设置（如Thymeleaf）在`application.properties`中指定模板编码： ```properties # Thymeleaf配置 spring.thymeleaf.encoding=UTF-8 spring.thymeleaf.servlet.content-type=text/html;charset=UTF-8 ``` ### 5. 添加字符编码过滤器手动注册`CharacterEncodingFilter`，确保请求和响应均使用UTF-8： ```java @Bean public FilterRegistrationBean<CharacterEncodingFilter> encodingFilter() { FilterRegistrationBean<CharacterEncodingFilter> bean = new FilterRegistrationBean<>(); bean.setFilter(new CharacterEncodingFilter()); bean.addInitParameter("encoding", "UTF-8"); bean.addInitParameter("forceEncoding", "true"); bean.addUrlPatterns("/*"); return bean; } ``` ### 6. 检查Tomcat容器配置（可选）若部署至外部Tomcat，在`server.xml`中配置URI编码： ```xml <Connector port="8080" URIEncoding="UTF-8" ... /> ``` ### 7. 验证响应头使用浏览器开发者工具检查响应头是否包含： ``` Content-Type: text/html;charset=UTF-8 ``` 若未生效，可通过拦截器强制设置： ```java @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new HandlerInterceptorAdapter() { @Override public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) { response.setCharacterEncoding("UTF-8"); response.setContentType("text/html;charset=UTF-8"); } }); } ``` ### 示例项目结构 ``` src/main/resources/ ├── static/ # 存放静态HTML文件 │ └── index.html # 确保UTF-8编码和<meta>标签 ├── templates/ # 模板引擎文件（如Thymeleaf） └── application.properties ``` ### 总结通过上述步骤，可系统性解决HTML页面乱码问题。核心在于统一文件编码、服务器配置、模板引擎设置及响应头控制[^1]。