ActiveRecord表名损坏问题求助：偶发PG::UndefinedTable错误

我之前帮过几个开发者排查过类似的问题，这个Puma环境下ActiveRecord表名被莫名追加"Cancelled"的错误，本质上大多是多进程/多线程环境下的内存共享或线程安全问题——毕竟你的Worker环境运行正常，只有Web端（Puma）出现，说明问题和Puma的进程/线程模型强相关。下面是具体的排查和解决方向：

1. 修复Puma fork后的ActiveRecord连接初始化 #

Puma的preload_app!机制会在fork子进程前预加载应用代码，如果ActiveRecord在预加载阶段建立了数据库连接或者缓存了模型信息，子进程会共享这些内存，后续并发请求可能导致内存污染。

在你的config/puma.rb里添加Worker启动后的连接重建逻辑：

preload_app!

on_worker_boot do
  # 重建ActiveRecord连接，避免子进程共享父进程的连接
  ActiveRecord::Base.establish_connection
  # 清理模型缓存，防止共享的缓存被篡改
  ActiveRecord::Base.clear_cache!
end

如果使用了phased_restart，这个配置尤为重要——它能确保每个新启动的Worker都有干净的数据库连接和模型缓存。

2. 排查模型中的线程不安全代码 #

检查你的模型代码，有没有使用全局变量、类变量来处理动态表名逻辑？比如下面这种写法在多线程环境下会直接导致表名被并发篡改：

# 错误示例：类变量@@table_name在多线程下不安全
class Foo < ApplicationRecord
  @@table_name = "foo"

  def self.switch_to_cancelled_table
    @@table_name = "foo_cancelled"
  end
end

如果有这类代码，替换成线程安全的实现，比如用Thread.current存储动态表名：

class Foo < ApplicationRecord
  def self.table_name
    Thread.current[:foo_table_name] || "foo"
  end

  def self.switch_to_cancelled_table
    Thread.current[:foo_table_name] = "foo_cancelled"
  end
end

3. 匹配Puma线程数与ActiveRecord连接池大小 #

如果Puma的线程数超过了ActiveRecord的连接池上限，会导致连接竞争，进而触发各种奇怪的内存异常。

• 在config/puma.rb里确认你的线程配置，比如：threads 5, 10
• 在config/database.yml里把对应的pool值设置为大于等于Puma的最大线程数：

  production:
    adapter: postgresql
    pool: 10
    # 其他配置...
  

4. 启用ActiveRecord线程安全模式 #

在config/application.rb里开启ActiveRecord的线程安全模式，确保内部操作不会被多线程干扰：

config.active_record.thread_safe!

这个配置会禁用ActiveRecord的一些非线程安全的优化，确保多线程环境下的稳定性。

5. 排查第三方Gem的影响 #

如果你的项目使用了多租户Gem（比如apartment）、动态表名Gem，或者拦截ActiveRecord查询的缓存Gem，这些工具可能在多线程环境下有线程安全漏洞。尝试暂时禁用这些Gem，观察错误是否消失，逐步定位问题来源。

6. 极端情况：排查内存损坏 #

如果以上步骤都无效，那可能是真的内存损坏问题：

• 用valgrind运行Ruby进程，检测内存访问异常；
• 使用Ruby的objspace库跟踪表名字符串的修改轨迹；
• 对服务器物理内存进行检测（比如用memtest86+），排除硬件故障。

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