ColdFusion无法识别特殊字符 CF模板内重音符号运行后被替换为问号

问题表现 #

CF模板中写入的带重音符号的配置内容，运行后重音字符会被自动替换为问号：
模板原始配置：

"SubjectPart1": {
     "Type": "String",
     "Default": "Notification : Points correctement transférés",
     "Description": "SubjectPart for ConfirmPointTransferReceiver_F"
}

运行后返回的异常内容：

"SubjectPart1": {
    "Type": "String",
    "Default": "Notification : Points correctement transf?r?s",
    "Description": "SubjectPart for ConfirmPointTransferReceiver_F"
}

问题根因 #

该问题是文件存储、服务处理、输出返回的全链路没有统一使用UTF-8编码导致的：当重音字符超出当前链路使用编码的支持范围时，会被直接替换为?占位符，按以下步骤逐一排查配置即可修复：

• 检查源文件保存编码
  所有CF模板、配置文件必须以UTF-8无BOM格式保存，不要使用ANSI、ISO-8859-1、GBK这类不支持西欧重音字符的编码格式保存文件，这类编码在被ColdFusion读取解析时，就会直接把无法识别的重音字符转成问号。
• 配置ColdFusion服务端全局编码
  登录ColdFusion管理员后台，进入「服务器设置-区域与语言」页面，将默认字符集修改为UTF-8。
  找到JVM启动参数配置项，追加以下参数后重启ColdFusion服务生效：

  -Dfile.encoding=UTF-8
  -Ddefault.client.encoding=UTF-8
  

• 统一模板页的编码声明
  所有涉及特殊字符输出的模板，在文件最开头添加编码处理指令，避免CF用默认非UTF-8编码解析页面、输出内容：

  <cfprocessingdirective pageencoding="UTF-8">
  <!-- 返回JSON格式配置时使用 -->
  <cfcontent type="application/json; charset=UTF-8">
  <!-- 返回HTML页面时替换为下面这行 -->
  <!-- <cfcontent type="text/html; charset=UTF-8"> -->
  

• 检查数据源/外部资源读取编码
  如果配置内容是从数据库、外部配置文件读取的，需要确认数据源连接配置指定了UTF-8编码，比如MySQL连接串需要追加useUnicode=true&characterEncoding=UTF-8参数，外部配置文件同样要确保是UTF-8编码保存，避免数据读取环节就已经出现字符损坏。

配置完成后可以新建测试模板直接输出transférés字符串验证，能正常显示重音字符后，再加载原有配置就不会出现字符被替换为问号的问题。

内容的提问来源于stack exchange，提问作者Fabrice Gaoudi