XPages向FacesContext发送UTF-8消息时出现瑞典语字符乱码如何排查

你观测到的Senaste beslutsdatum i kundkommittén属于典型的UTF-8编码字节被错误按ISO-8859-1（Latin-1）单字节规则解码产生的乱码：瑞典语特殊字符é的UTF-8编码为双字节序列0xC3 0xA9，按Latin-1解码后正好对应字符é，和实际现象完全匹配。按照从资源加载到页面渲染的全链路顺序，常见错误点及修复方式如下：

资源加载环节的Domino专属坑 #

你编写的Properties读取代码逻辑本身没有语法问题，但Domino对NSF内部资源的流处理有特殊逻辑：

• ExternalContext.getResourceAsStream()获取NSF内存储的文件资源时，若资源未提前配置明确的MIME编码，Domino会在返回InputStream之前，按服务器平台默认编码（通常为CP1252/ISO-8859-1）对原始文件字节做一次预解码转换。这种情况下哪怕你后续用InputStreamReader指定UTF-8格式读入，拿到的内容也已经是被错误转码过的字符串，无法还原正确的字符。
• 修复方式：在Domino Designer中右键NSF内的.properties文件 → 打开资源属性面板 → 确认文件的内容类型设为text/plain，并手动指定内容编码为UTF-8，关闭Domino对该资源的预转码逻辑。

JVM全局编码配置不匹配 #

老版本Domino服务器的JVM默认未指定UTF-8编码，会沿用操作系统的ANSI编码规则（通常为ISO-8859-1）。即便代码中显式指定了读取编码，链路中所有隐式的编码转换环节仍会按JVM默认编码处理内容。

• 修复方式：编辑Domino服务器的jvm.properties配置文件，在JVM启动参数中添加file.encoding=UTF-8，重启服务器后将全局默认编码切换为UTF-8。

页面渲染的字符集配置缺失 #

如果XPages生成的响应未明确声明UTF-8字符集，浏览器会默认按页面预设的编码规则解析内容。这种情况下即便Java层传递的消息字符串是完全正确的，渲染到页面时仍会因解码规则不匹配出现乱码。

• 修复方式：在NSF的xsp.properties配置中添加全局规则xsp.html.page.encoding=UTF-8，确保所有XPage输出的HTTP响应头携带charset=UTF-8声明，强制浏览器按UTF-8解析全部页面内容。

快速定位断点方法 #

可以在读取到properties中的消息文本后，添加日志打印内容的原始字节，直接定位问题出现的链路节点：

// 读取msg变量后插入验证代码
XspOpenLogUtil.logEvent("消息原始UTF-8字节: " + Arrays.toString(msg.getBytes(StandardCharsets.UTF_8)));

• 如果日志打印的字节序列中，é对应的片段为[-60, -87]（即十六进制的0xC3、0xA9），说明Java层拿到的字符串完全正确，问题出在后续的页面渲染编码环节；
• 如果日志打印的字节序列为[-61, -127, -62, -87]，说明资源读取环节就已经发生转码错误，问题出在Domino的资源流预转码逻辑上。

内容的提问来源于stack exchange，提问作者Patrick Kwinten