不同环境执行rails db:schema:dump生成的structure.sql差异排查求助

我们基于Ruby on Rails开发应用，使用PostgreSQL数据库，其中定义了一个视图。在不同本地开发环境执行rails db:migrate或rails db:schema:dump时，生成的structure.sql中视图的SQL出现了无意义的等效差异——这些SQL在功能上完全一致，但会给Git版本管理带来不必要的麻烦。

原视图定义片段：

WHERE name IN ('foo', 'bar')

不同开发环境生成的差异版本：

WHERE ((name):text = ANY (ARRAY[('foo'::character varying)::text, ('bar'::character varying)::text]))
WHERE ((name):text = ANY ((ARRAY['foo'::character varying, 'bar'::character varying])::text[]))
WHERE name::text = ANY (ARRAY['foo'::character varying::text, 'bar'::character varying::text])

目前已确认所有开发者的环境一致性：

• Ruby版本：3.3.0
• Ruby on Rails版本：7.1.3
• pg gem版本：1.5.6
• PostgreSQL版本：15.6
• 数据库初始化流程一致：通过相同脚本导入相同备份并执行db:migrate

排查思路 #

1. 对比PostgreSQL配置参数差异 #

尽管数据库版本统一，但不同本地环境的postgresql.conf可能存在影响SQL格式化的参数差异，重点检查：

• standard_conforming_strings：控制字符串字面量的解析规则
• array_nulls：影响数组生成的格式细节
• search_path：schema搜索路径不同可能导致类型转换的显式程度变化
• 数据库的排序规则（datcollate）和字符类型（datctype）：可通过执行SELECT datname, datcollate, datctype FROM pg_database;获取并对比

让所有开发者执行SHOW ALL;导出配置，对比上述关键参数的取值是否一致。

2. 检查pg gem的本地编译差异 #

虽然pg gem版本相同，但不同操作系统（如macOS vs Linux）或编译环境（不同编译器版本）可能导致gem的行为出现细微差异，尤其是在SQL解析和导出逻辑上。可以让开发者检查本地pg gem的编译日志，或者尝试在相同系统环境下复现问题，确认是否是编译环境导致的差异。

3. 验证Rails的schema dump配置 #

检查项目中的Rails配置文件（config/application.rb、config/environments/development.rb），确认是否存在自定义的schema dump相关配置，或引入了第三方gem（如schema_plus）影响SQL导出格式。

另外，Rails的db:schema:dump是通过调用PostgreSQL的pg_get_viewdef函数获取视图定义的，不同环境下该函数返回的格式差异可能是问题根源，这通常和数据库内部状态或配置相关。

4. 检查视图迁移脚本的动态逻辑 #

确认创建视图的迁移脚本是否存在动态生成SQL的逻辑，比如依赖本地环境变量、使用不同的字符串拼接方式，导致不同环境下创建视图的原始SQL就存在差异。确保迁移脚本使用硬编码的统一SQL，避免动态生成逻辑。

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