当前位置：首页 > news >正文

Spring + Tomcat项目中nacos配置中文乱码问题解决

news 来源：原创 2025/5/1 17:15:04

实际工作的时候碰到了nacos中文乱码的问题，一顿排查最终还是调源码解决了。下面为具体的源码流程，有碰到的可以参考下。

对于nacos配置来说，初始主要源码就在NacosConfigService类中。里面有初始化获取配置content以及设置对应监听器的操作。具体可以参考：详解Nacos 配置中心客户端配置缓存动态更新的源码实现 - 简书

对于监听器，我们可以通过注解@NacosConfigListener去自定义监听器。但我们通@NacosValue注解配置的一些配置能进行动态刷新，就意味着nacos内部肯定有自定义的监听器，也是靠这个监听器进行数据的动态刷新。对应的类为NacosPropertySourcePostProcessor，具体的方法流程图如下：

addListenerIfAutoRefreshed -> receiveConfigInfo -> NacosPropertySource newNacosPropertySource = new NacosPropertySource(dataId, groupId, name, config, type);

上述初始化NacosPropertySource 的过程就是导致nacos配置中文乱码的原因
跟进初始化方法如下：
public NacosPropertySource(String dataId, String groupId, String name,
    String nacosConfig, String type) {
		super(name, toProperties(dataId, groupId, nacosConfig, type));
		this.type = type;
}


toProperties(dataId, groupId, nacosConfig, type) -> ConfigParseUtils.toProperties(dataId, group, text, type) -> toProperties(context, type) -> configParse.parse(context) 其中configParse为DefaultPropertiesConfigParse -> loader.load() -> load(true) -> OriginTrackedPropertiesLoader.CharacterReader reader = new OriginTrackedPropertiesLoader.CharacterReader(this.resource);

而其中异常原因就在new OriginTrackedPropertiesLoader.CharacterReader( this.resource) 这行代码中，点进去代码如下，其中编码格式为ISO_8859_1。导致中文解析就乱码。