Rails ActiveRecord连接池配置中的类缓存问题解析

问题背景

在Rails框架的ActiveRecord组件中，连接池配置(PoolConfig)会缓存连接类(connection_class)。这一设计在开发环境下会导致一个潜在问题：当连接类被重新加载(reload)时，缓存中的类引用与重新加载后的类实例不再匹配。

问题表现

这个问题在实际应用中表现为：当使用connected_to方法切换数据库连接角色时，如果连接类被重新加载，写入保护(prevent_writes)等设置会失效。例如在SolidCache这样的插件中，即使明确指定了prevent_writes: false，重新加载后连接仍会保持写入保护状态。

技术原理

ActiveRecord的PoolConfig内部会存储连接类的引用。在开发环境下，当代码修改触发自动重新加载机制时，旧的类实例会被丢弃，新加载的类实例会创建。但由于PoolConfig中缓存的是旧类的引用，导致后续的类检查(如preventing_writes?)会基于错误的类引用进行判断。

解决方案

核心解决思路是避免直接缓存类引用，改为缓存类的名称和关键属性。具体实现包括：

1. 在PoolConfig中存储连接类的名称字符串而非类引用
2. 额外缓存类是否为primary_class的布尔值
3. 在需要时通过constantize动态获取类实例

这种方案虽然会在运行时增加少量的字符串处理和常量查找开销，但确保了在类重新加载后仍能正确工作。对于生产环境，这种开销可以忽略不计。

实现细节

修改后的PoolConfig会：

• 在初始化时记录类名称和primary_class状态
• 通过connection_class方法动态查找类实例
• 保持connection_name方法的原有行为不变

影响范围

这一改动主要影响以下场景：

• 开发环境下使用自动代码重新加载
• 自定义ActiveRecord连接类的应用
• 使用多数据库连接和分片(shard)功能的项目

最佳实践

对于插件开发者：

• 考虑将连接类标记为不可重新加载
• 在文档中明确说明连接类的使用限制

对于应用开发者：

• 了解这一限制对自定义连接类的影响
• 在需要重新加载时注意连接状态的正确性

这一改进已被合并到Rails主分支，将在未来的版本中发布，为开发者提供更稳定的连接管理体验。