will_paginate报错“参数数量不符：给定2，预期1”的排查求助

可能的原因及解决步骤 #

1. 排查分页gem冲突 #

检查项目的Gemfile和Gemfile.lock，确认是否同时安装了kaminari或其他分页相关gem。不同分页gem的方法可能存在命名冲突，导致will_paginate被意外重定义。

• 移除冲突的gem，执行bundle install后重新部署到Heroku。

2. 调整查询链顺序 #

原代码中先调用paginate再调用order，可能导致返回的对象并非WillPaginate::Collection类型，从而引发视图调用错误。将order移到paginate之前：

def index
  @publications = Publication.order('sort_date DESC').paginate(page: params[:page], per_page: 11)
end

3. 检查自定义helper覆盖 #

查看app/helpers目录下的所有文件，确认是否存在自定义的will_paginate方法。若有自定义方法覆盖了gem提供的原生方法，会导致参数数量不匹配。

• 重命名或删除该自定义方法，重启应用后测试。

4. 确认gem版本兼容性 #

确保will_paginate版本与当前Rails版本匹配：

• 在Gemfile中指定兼容版本，例如针对Rails 7.x使用：

  gem 'will_paginate', '~> 4.0.0'
  

• 执行bundle install并重新部署到Heroku。

5. 清除Heroku缓存 #

若本地测试正常但Heroku上仍报错，可能是缓存问题：

• 执行命令清除Heroku缓存：

  heroku repo:purge_cache
  

• 重新部署应用。

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