构建安全的Web3.0应用,欧义视角下的字符集过滤器设置指南

配置过滤器（以web.xml为例）：

<filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</filter-class>
    <!-- 或者自定义的过滤器全限定类名 -->
    <!-- <filter-class>com.ouyi.web3.filter.CustomCharacterEncodingFilter</filter-class> -->
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
        <param-name>forceEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern> <!-- 拦截所有请求 -->
</filter-mapping>

• encoding：指定字符集为UTF-8。
• forceEncoding：设置为true，确保即使请求已指定编码，也会被强制设置为UTF-8，保证一致性。

在Spring Boot等现代框架中的配置： Spring Boot简化了配置，通常通过application.properties或application.yml即可：

# Spring Boot配置字符集
server.servlet.encoding.force=true
server.servlet.encoding.charset=UTF-8
server.servlet.encoding.enabled=true

或者通过Java配置类：

@Configuration
@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        // 配置消息转换器，默认使用UTF-8
        StringHttpMessageConverter converter = new StringHttpMessageConverter(StandardCharsets.UTF_8);
        converter.setWriteAcceptCharset(false); // 推荐设置
        converters.add(converter);
    }
    @Bean
    public CharacterEncodingFilter characterEncodingFilter() {
        CharacterEncodingFilter filter = new CharacterEncodingFilter();
        filter.setEncoding("UTF-8");
        filter.setForceEncoding(true);
        return filter;
    }
}

欧义Web3.0的特殊考量：

• 钱包交互：确保与用户钱包（如MetaMask）的通信数据采用UTF-8编码，特别是交易备注、合约方法参数中的字符串。
• 智能合约事件：解析智能合约 emitted 的事件日志时，确保字符串类型的字段以UTF-8正确解码。
• 去中心化存储：如果应用涉及IPFS等去中心化存储，存储的文本文件应明确声明UTF-8编码，并在读取时遵循。
• API设计：Web3.0的API（如JSON-RPC）响应应明确包含Content-Type: application/json; charset=utf-8头部。