Rails项目中ransack gem在Heroku Postgres数据库上无法正常工作

问题背景 #

• 本地SQLite3环境下Ransack搜索功能正常运行
• 部署到Heroku（PostgreSQL数据库）后，搜索操作触发数据库错误
• 本地与Heroku数据库均已完成最新迁移

用户提供代码 #

视图代码 #

<%= search_form_for @q do |f| %>

  <!--Search if the name field contains...-->
  <%= f.label :blue_corner_cont%>
  <%= f.search_field :blue_corner_or_red_corner_or_date_cont, class: "input-group-text" %>
</div>

控制器代码 #

def index
   
    #ransakc search
    @q= Fight.ransack(params[:q])
     @fights = @q.result
    
end

问题分析 #

Heroku使用PostgreSQL，本地是SQLite，两者SQL语法处理存在核心差异：
Ransack的_cont匹配器会自动对字段值调用lower()函数实现大小写不敏感匹配，但PostgreSQL中**date类型无法直接使用lower()函数**，SQLite对类型约束宽松所以不会触发报错，这就是部署后出错的根本原因。

解决方案 #

方案1：拆分搜索字段（推荐） #

将日期字段的搜索改为适合日期类型的匹配器（如_eq精确匹配、_gte/_lte范围匹配），与文本字段分开处理：

<%= search_form_for @q do |f| %>
  <%= f.label :blue_corner_or_red_corner_cont, "选手姓名" %>
  <%= f.search_field :blue_corner_or_red_corner_cont, class: "input-group-text" %>

  <%= f.label :date_eq, "比赛日期" %>
  <%= f.date_field :date_eq, class: "input-group-text" %>

  <%= f.submit "搜索" %>
<% end %>

方案2：自定义日期字符串匹配器 #

如果需要在单个输入框中同时搜索文本和日期字符串，可在Fight模型中定义自定义ransacker，将日期转为字符串后再匹配：

class Fight < ApplicationRecord
  ransacker :date_string do
    Arel.sql("to_char(date, 'YYYY-MM-DD')")
  end
end

修改视图中的搜索字段：

<%= search_form_for @q do |f| %>
  <%= f.label :blue_corner_or_red_corner_or_date_string_cont%>
  <%= f.search_field :blue_corner_or_red_corner_or_date_string_cont, class: "input-group-text" %>
<% end %>

验证步骤 #

1. 部署修改后的代码到Heroku
2. 执行heroku logs --tail实时查看日志，确认搜索请求无报错
3. 测试搜索功能，验证文本和日期搜索均正常工作

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