Heroku生产环境下RoR应用ModelTwo中ModelOne查询失效问题

这种场景我之前碰到过好几次，本地和测试环境都正常，唯独Heroku生产环境里关联查询出问题，而且控制台里又能查到正确结果，大概率是生产环境特有的事务、缓存或者连接逻辑导致的，给你梳理几个具体的排查和解决思路：

1. 先排查事务隔离的问题 #

如果你的代码是在一个数据库事务里执行的，而且ModelOne的数据是在这个事务内部创建的，那在事务提交之前，当前请求里的后续代码可能看不到这些数据——但heroku run rails c是在事务外部执行的，所以能查到。

• 怎么查：看看调用self.model_one.any?的代码是不是被包在ActiveRecord::Base.transaction块里，或者是不是刚创建完ModelOne就立刻执行这个查询。
• 解决办法：如果是事务的锅，要么把查询逻辑挪到事务提交之后，要么用transaction(requires_new: true)开启一个独立的子事务（不过子事务要注意性能开销，别乱用）。

2. 检查关联加载的方式有没有被干扰 #

Rails的懒加载有时候在生产环境会因为缓存或者字段缺失出问题，尤其是如果你用了select只查ModelTwo的部分字段，可能导致关联无法正确加载。

• 怎么查：
  • 先确认ModelTwo的关联定义有没有错，比如has_many :model_ones, foreign_key: 'your_foreign_key'，要保证外键和数据库里的字段名完全一致。
  • 看看查询ModelTwo的代码是不是用了select只取了部分字段，比如ModelTwo.select(:id, :name).find(params[:id])，这种情况下懒加载关联时会重新发查询，但如果缺了外键字段就会查不到数据。
• 解决办法：
  • 显式预加载关联：把查询改成ModelTwo.includes(:model_ones).find(params[:id])，提前把关联数据加载好。
  • 避免用select排除关联需要的字段，比如外键字段一定要包含在查询里。

3. 排查生产环境的查询缓存 #

Heroku生产环境默认会开查询缓存，或者你自己加了自定义缓存逻辑，可能导致关联查询的结果被缓存成空值了。

• 怎么查：
  • 看看config/environments/production.rb里的config.action_controller.perform_caching和config.cache_store设置，是不是开了比较激进的缓存。
  • 检查代码里有没有手动缓存ModelOne或ModelTwo的查询，比如用了Rails.cache.fetch。
• 解决办法：
  • 针对这个关联查询跳过缓存：用uncached块包裹，比如ModelTwo.uncached { self.model_one.any? }。
  • 手动清理Heroku的缓存：执行heroku run rails cache:clear试试。

4. 验证数据库连接的一致性 #

有时候Heroku的数据库连接池会出现连接异常的情况，某个连接可能处于错误状态，导致查询返回空，但rails c用的是新连接，所以正常。

• 怎么查：看Heroku的实时日志（heroku logs --tail），有没有数据库连接相关的错误，比如connection refused或者timeout。
• 解决办法：
  • 重启Heroku应用：heroku restart，强制刷新所有数据库连接。
  • 调整连接池大小：在config/database.yml的production部分设置pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>，确保和应用的线程数匹配。

5. 检查全局作用域的影响 #

如果ModelOne定义了default_scope，可能因为生产环境的环境变量设置不对，导致作用域把所有数据都过滤掉了，但控制台里的环境变量是对的。

• 怎么查：看看ModelOne的代码有没有类似default_scope -> { where(status: ENV['ACTIVE_STATUS']) }的逻辑，然后用heroku config:get ACTIVE_STATUS检查环境变量是否正确。
• 解决办法：
  • 修正环境变量的值，或者在查询关联时跳过默认作用域：self.model_one.unscoped.any?。

最后给你个小技巧：在生产环境的代码里临时加一行日志，输出关联查询的SQL语句：

Rails.logger.info "ModelOne关联查询SQL: #{self.model_one.to_sql}"

然后看Heroku日志，对比rails c里执行的SQL，两者的差异往往能直接帮你定位问题。

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