背景

区分 UTF-8 和 GBK

GBK 是在国家标准 GB2312 基础上扩容后兼容 GB2312 的标准，专门用来解决中文编码的，是双字节的，不论中英文都是双字节的。

UTF-8 是一种国际化的编码方式，包含了世界上大部分的语种文字（简体中文字、繁体中文字、英文、日文、韩文等语言），也兼容 ASCII 码。

虽然 GBK 比 UTF-8 少节省两个字节，但是 GBK 只包含中文，UTF-8 则包含全世界所有国家需要用到的字符，所以现在很多系统或者框架处理都默认使用 UTF-8 。

不过业务开发对接系统接口的时候，经常会碰到一些老系统使用 GBK 编码，特别是国内支付，这个时候需要兼容 GBK 和 UTF-8 编码。

如何让项目兼容 UTF-8 和 GBK

我们使用 spring boot 2.7 版本。我们默认API使用 UTF-8 ，特别的 API 使用 GBK。在 spring boot 中，当收到请求解析前会通过 CharacterEncodingFilter 进行内容编码格式指定。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
	@Override
	protected void doFilterInternal(
			HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
			throws ServletException, IOException {
		String encoding = getEncoding();
		if (encoding != null) {
      // 请求进来设置编码（设置了请求强制转编码或请求头未设置编码时）
			if (isForceRequestEncoding() || request.getCharacterEncoding() == null) {
				request.setCharacterEncoding(encoding);
			}
      // 设置了响应强制转编码
			if (isForceResponseEncoding()) {
				response.setCharacterEncoding(encoding);
			}
		}
		filterChain.doFilter(request, response);
	}

通过以下方式可以修改项目全局的编码方式

1
2
3
4
5
6
7
server:
  servlet:
    encoding:
      charset: UTF-8
      force-request: false
      force-response: false

看下默认情况下，编码格式 UTF-8 并且每次都强制转换，什么意思？也就是就算你请求头 application/json;charset=GBK 这样也不会按照头的编码解析，会强制给你转成 UTF-8，如果是 GBK 过来的内容，你就等着吃乱码吧！

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
	@Bean
	@ConditionalOnMissingBean
	public CharacterEncodingFilter characterEncodingFilter() {
		CharacterEncodingFilter filter = new OrderedCharacterEncodingFilter();
		filter.setEncoding(this.properties.getCharset().name());
		filter.setForceRequestEncoding(this.properties.shouldForce(Encoding.Type.REQUEST));
		filter.setForceResponseEncoding(this.properties.shouldForce(Encoding.Type.RESPONSE));
		return filter;
	}
public boolean shouldForce(Type type) {
		Boolean force = (type != Type.REQUEST) ? this.forceResponse : this.forceRequest;
		if (force == null) {
			force = this.force;
		}
		if (force == null) {
			force = (type == Type.REQUEST);
		}
		return force;
	}

现在有一个支付系统，它请求的内容是 GBK 编码，并且有 GET 和 POST 两种方式过来，我们系统接口默认是 UTF-8，所以只有针对特定的 GBK 接口进行处理。需要支持下面几种请求情况。

  1. POST 对方的请求内容 GBK 编码并且请求头里指定了编码方式 application/json;charset=GBK。
  2. POST 对方的请求内容 GBK 编码并且请求头里未指定编码方式 application/json。
  3. GET 对方的请求内容 GBK 编码。

第一种情况，我们只需要关闭强制转换，带了charset=gbk，就会使用 gbk 编码进行解析，默认不带则使用 utf-8 解析。

1
2
3
4
5
server:
  servlet:
    encoding:
			force: false

第二种和第三种情况，我们需要先关闭强制转换，然后添加一个优先级很高的过滤器将指定的请求设置为 GBK 编码格式（也就是在进入spring 解析前就要处理），如果使用 tomcat 容器的话如下处理。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
@Slf4j
@Configuration
public class GBKFilterConfig {
    @Bean
    public FilterRegistrationBean gbkFilter() {
        FilterRegistrationBean registration = new FilterRegistrationBean();
        registration.setDispatcherTypes(DispatcherType.REQUEST);
        registration.setFilter(new Filter() {
            @Override
            public void init(javax.servlet.FilterConfig filterConfig) throws ServletException {
            }
            @Override
            public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
                    throws IOException, ServletException {
                RequestFacade req = (RequestFacade) request;
                Class clazz = req.getClass();
                log.info("GBK Filter...");
                try {
                    Field field = clazz.getDeclaredField("request");
                    field.setAccessible(true);
                    Request r = (Request) field.get(req);
                    org.apache.coyote.Request p = r.getCoyoteRequest();
                    // GET 请求参数强使用 GBK 编码。
                    p.getParameters().setQueryStringCharset(Charset.forName("GBK"));
                    // POST 请求带头未指定编码，强制使用 GBK
                    p.getParameters().setCharset(Charset.forName("GBK"));
                    p.setCharset(Charset.forName("GBK"));
                    chain.doFilter(request, response);
                } catch (Exception e) {
                   log.error("error", e)
                }
            }
            @Override
            public void destroy() {
            }
        });
        registration.addUrlPatterns("/api/gbk/**");
        registration.setName("gbkFilter");
        registration.setOrder(Integer.MIN_VALUE);
        return registration;
    }
}