Spring Boot与Jackson字符编码转换配置及数据编码适配问题

我来帮你一步步搞定这个编码转换的问题，结合你的Spring Boot REST服务场景和业务流程，分点给你讲清楚：

一、Spring REST服务中Jackson的编码转换配置 #

首先得明确一个核心点：JSON的传输编码必须是UTF-8（这是RFC规范强制要求的），所以客户端发过来的请求肯定是UTF-8编码的JSON。你的需求是把这些数据转成ISO-8859-1给下游用，响应时再把下游的ISO-8859-1数据转成UTF-8的JSON返回给客户端。

这里有两种靠谱的实现方式：

方式1：自定义Jackson的字符串序列化/反序列化器 #

因为Java里的字符串本质是Unicode，我们可以通过自定义序列化器和反序列化器，在Jackson处理数据的阶段完成编码逻辑：

首先写一个序列化器，负责把从下游拿到的ISO-8859-1解码后的Java字符串，正常序列化为UTF-8的JSON（其实Jackson默认就是这么做的，这个序列化器主要是兜底确保逻辑清晰）：

import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.SerializerProvider;
import com.fasterxml.jackson.databind.ser.std.StdSerializer;
import java.io.IOException;

public class IsoToUtf8StringSerializer extends StdSerializer<String> {
    public IsoToUtf8StringSerializer() {
        super(String.class);
    }

    @Override
    public void serialize(String value, JsonGenerator gen, SerializerProvider provider) throws IOException {
        // 直接写入字符串，Jackson会自动用UTF-8编码输出
        gen.writeString(value);
    }
}

然后写一个反序列化器，把客户端发来的UTF-8 JSON字符串解析成Java字符串后，后续存储时可以直接用ISO-8859-1编码（这里不需要在反序列化器里硬转，因为Java字符串是Unicode，存储时转字节更灵活）：

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.deser.std.StdDeserializer;
import java.io.IOException;

public class Utf8ToIsoStringDeserializer extends StdDeserializer<String> {
    public Utf8ToIsoStringDeserializer() {
        super(String.class);
    }

    @Override
    public String deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        // 直接拿到解析后的Unicode字符串，后续存储时转ISO-8859-1字节即可
        return p.getValueAsString();
    }
}

接下来在Spring Boot里配置Jackson，注册这两个自定义类：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        SimpleModule module = new SimpleModule();
        module.addSerializer(String.class, new IsoToUtf8StringSerializer());
        module.addDeserializer(String.class, new Utf8ToIsoStringDeserializer());
        objectMapper.registerModule(module);
        return objectMapper;
    }
}

不过说实话，更简单的方式是在数据访问层处理编码：存数据时，把Java字符串用StandardCharsets.ISO_8859_1转成字节；读数据时，用StandardCharsets.ISO_8859_1把字节解码成Java字符串。Jackson只负责处理JSON的UTF-8编码，这样职责更清晰，也不容易出问题。

方式2：配置Spring消息转换器的编码 #

如果你想在消息传输层面统一处理，可以配置MappingJackson2HttpMessageConverter，确保请求和响应的编码都是UTF-8（这其实是Spring的默认配置，但手动配置更保险）：

import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import java.nio.charset.StandardCharsets;
import java.util.List;

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
        // 设置默认编码为UTF-8，确保请求和响应都用这个编码
        converter.setDefaultCharset(StandardCharsets.UTF_8);
        converters.add(converter);
    }
}

这个方式只是确保JSON的传输编码是UTF-8，字符串内容的编码转换还是要在业务层或数据层处理。

二、你的业务流程两个问题的解答 #

问题1：步骤2中，更简洁的ISO-8859-1转UTF-8方式 #

步骤2是读ISO-8859-1文件，生成UTF-8的JSON。最简洁的做法就是：

• 读文件时直接用StandardCharsets.ISO_8859_1解码成Java字符串（Unicode）；
• 然后用Jackson正常序列化这个Java对象，Jackson默认会生成UTF-8编码的JSON，完全符合规范，接口调用不会出问题。

给你个示例代码：

import java.nio.file.Files;
import java.nio.file.Paths;
import java.nio.charset.StandardCharsets;
import com.fasterxml.jackson.databind.ObjectMapper;

// 读取ISO-8859-1编码的文件
String fileContent = Files.readString(Paths.get("你的文件路径.txt"), StandardCharsets.ISO_8859_1);
// 把文件内容解析成你的业务对象（比如MyData类）
MyData data = parseFileContentToData(fileContent);
// Jackson生成UTF-8的JSON
ObjectMapper mapper = new ObjectMapper();
String json = mapper.writeValueAsString(data);

完全不需要额外的编码转换，Java字符串的Unicode特性帮你搞定了中间的转换逻辑。

问题2：步骤4导出ISO-8859-1文件时，确保转换正确 #

步骤4是把数据库的UTF-8数据导出成ISO-8859-1的平面文件。要注意这几点：

1. 从数据库读数据时，确保JDBC连接配置了UTF-8编码（比如url里加useUnicode=true&characterEncoding=UTF-8），这样数据库的UTF-8数据会被正确解码成Java字符串；
2. 把Java字符串用StandardCharsets.ISO_8859_1编码成字节；
3. 直接把这些字节写入文件，不要额外解码。

示例代码：

import java.nio.file.Files;
import java.nio.file.Paths;
import java.nio.charset.StandardCharsets;

// 从数据库读取业务对象
MyData data = yourDataRepository.findById(1L);
// 把对象转成要导出的字符串格式（比如CSV、普通文本）
String exportContent = convertDataToString(data);
// 转成ISO-8859-1字节
byte[] isoBytes = exportContent.getBytes(StandardCharsets.ISO_8859_1);
// 写入文件
Files.write(Paths.get("导出文件路径.txt"), isoBytes);

重要提醒：如果数据库里的UTF-8数据包含ISO-8859-1不支持的字符（比如中文、emoji），转换时这些字符会变成?丢失。如果你的数据确实只在ISO-8859-1的单字节子集里，那没问题；如果有超出的字符，提前做替换或者报错处理。

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