Rails中针对enum类型字段如何实现带LIKE匹配的检索查询

Rails枚举字段在数据库层存储的是整数映射值，并非字符串状态名。你直接对整数类型的task_status字段使用LIKE匹配时，PostgreSQL会因为整数类型没有定义和字符串的LIKE运算符（底层即~~操作符），抛出PG::UndefinedFunction类型不匹配错误。

注意：仅靠报错提示的“显式类型转换”把task_status转成文本是没用的——整数转文本后得到的是"1"、"2"这类数字字符串，根本无法匹配"pend"这类状态名称关键词，查不到正确结果。

最优实现方案 #

方案1：Ruby层枚举白名单匹配 + 原生条件查询 #

这是最符合Rails设计、性能最好、可维护性最高的实现。
Rails会为每个枚举自动生成状态名与整数值的固定映射常量，对应你项目中的ConfirmedTask.task_statuses（内容为{"pending" => 1, "complete" => 2}）。你可以先在代码层用搜索关键词匹配符合条件的状态名，再直接使用Rails原生的枚举查询能力过滤记录：

# 从枚举固定映射中筛选所有名称包含搜索关键词的状态值，通过Regexp.escape处理特殊字符避免正则错误
matched_statuses = ConfirmedTask.task_statuses.filter_map do |status_name, status_value|
  status_value if status_name.match?(/#{Regexp.escape(search_keyword)}/i)
end
# 直接用Rails原生的枚举条件查询，命中整数字段的数据库索引
ConfirmedTask.where(task_status: matched_statuses)

方案优势：

• 无硬编码映射关系，后续枚举新增/调整状态时代码无需改动
• 查询为整数字段等值匹配，可正常命中task_status字段上的B-tree索引，大表下性能表现稳定
• 所有匹配逻辑都在枚举白名单内完成，不存在用户输入直接拼接SQL的注入风险

针对你传入"pend"关键词的场景，这段代码会筛选出值为1的pending状态记录，完全符合需求。

方案2：数据库层动态映射后LIKE匹配（仅小表适用） #

如果必须在数据库查询层完成关键词匹配，不能先在Ruby层做筛选，就需要先通过CASE WHEN把数据库存储的整数值映射为对应的状态名称，再执行LIKE匹配，避免硬编码映射关系：

# 从枚举映射动态生成CASE WHEN片段，杜绝硬编码
case_mapping_sql = ConfirmedTask.task_statuses.map { |name, value| "WHEN #{value} THEN '#{name}'" }.join(" ")
# 执行映射后的LIKE查询
ConfirmedTask.where("CASE task_status #{case_mapping_sql} END LIKE ?", "%#{search_keyword}%")

方案局限：

• 查询使用CASE表达式做字段值转换，无法命中task_status字段的普通索引，大表查询时性能会明显下降
• 动态拼接SQL时需确保所有值都是代码内定义的固定枚举值，不要直接拼接用户输入内容，避免注入风险

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