Rails中数组列查询含特殊字符的记录失败，如何解决？

问题场景 #

我在Rails项目中使用Ethnicity模型，其中包含一个alternate_labels字符串数组列，Schema定义如下：

t.string "alternate_labels", default: [], array: true

示例数据记录：

{name: "Withhold", alternate_labels: ["Prefer Not to Say"]}

有一条记录在匹配时出现问题：

{name: "White", alternate_labels: ["Caucasian", "White, (not of Hispanic / Latin origin)"]}

我原本用以下代码匹配调查响应与数据库记录，大部分场景都能正常工作：

Ethnicity.find_by("alternate_labels && ?", "{#{survey_response.race}}")

但当survey_response.race的值为"White, (not of Hispanic / Latin origin)"时，查询返回nil。推测是字符串中的括号、斜杠等特殊字符未正确转义导致的。

解决方案 #

不要手动拼接数组格式的字符串，改用PostgreSQL原生的数组匹配语法，让Rails自动处理参数绑定与转义：

方案1：使用ANY操作符（推荐） #

直接检查目标值是否存在于数组列中，语法清晰且自动处理特殊字符：

Ethnicity.find_by("? = ANY(alternate_labels)", survey_response.race)

方案2：使用数组参数绑定 #

如果需要保留数组交集(&&)的逻辑，不要手动包裹{}，而是让Rails生成正确的数组参数：

Ethnicity.find_by("alternate_labels && ARRAY[?]", survey_response.race)

问题原因 #

之前的写法中，手动拼接{#{survey_response.race}}会让特殊字符破坏PostgreSQL的数组语法结构，导致数据库无法正确解析这个数组参数，因此匹配失败。而使用参数绑定的方式，Rails会自动对特殊字符进行转义，确保数组格式正确，无需手动处理转义，也不需要修改数据库中已存储的列值。

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