cfinvokeargument传入含特殊字符值时SELECT查询匹配失败问题

你代码中已经正确使用了CF_SQL_NVARCHAR类型的cfqueryparam适配数据库的Unicode字段，出现特殊字符查询失败的核心原因是全链路字符编码不匹配，常见触发场景如下：

• ColdFusion运行时、参数传递链路、数据库连接三者的字符编码不一致，导致José中的重音字符é在传输过程中被转换为错误的字节序列，最终传入查询的实际值和数据库中存储的正确值不匹配。
• 数据源JDBC连接未显式开启Unicode参数传输支持，特殊字符被默认用ASCII编码转义丢失原有特征。
• 部分场景下cfinvoke传递参数时，特殊字符被自动转义为HTML实体（例如é被转成é），传入查询的是实体编码而非原始字符，无法匹配到数据库记录。

按照优先级依次排查修复：

1. 验证参数传递正确性
   在getPerson函数开头插入调试代码，确认传入的name参数是否正常：

<cfdump var="#name#" abort>

如果输出的name为乱码或HTML实体，说明问题出在参数传递阶段，对应修复：

• 在当前页面顶部添加<cfprocessingdirective pageEncoding="utf-8">显式指定页面编码，也可直接在ColdFusion管理员后台的「设置」页将全局默认编码改为UTF-8。
• 如果参数源自前端提交，确保前端页面已设置<meta charset="UTF-8">，表单提交编码为UTF-8。

2. 修复数据源Unicode传输配置
   这是这类问题最常见的诱因，根据你使用的数据库修改JDBC连接串，修改后需重启ColdFusion服务生效：

• SQL Server：在连接串末尾追加;sendStringParametersAsUnicode=true，强制字符串参数以Unicode格式传输到数据库。
• MySQL：在连接串末尾追加;useUnicode=true&characterEncoding=UTF-8，指定UTF-8编码传输所有参数。

3. 排序规则适配（可选）
   如果确认参数值正确但仍匹配失败，大概率是数据库字段的排序规则设置了区分重音，可临时修改查询语句指定不区分重音的匹配规则（以SQL Server为例）：

<cfquery name="qry" datasource="#datasource#">
    SELECT id
    FROM people
    WHERE name = <cfqueryparam value="#name#" cfsqltype="CF_SQL_NVARCHAR"> COLLATE SQL_Latin1_General_CP1_CI_AI
</cfquery>

规则后缀CI代表不区分大小写，AI代表不区分重音，可根据实际业务需求调整。

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