Rails7与Ruby3下哈希合并未按预期覆盖值的问题

问题原因分析 #

1. 合并顺序错误：你执行的first_hash.merge(template_hash)逻辑是将template_hash的键值对合并到first_hash中，相同键会被template_hash的值覆盖，这和你需要的「用first_hash覆盖共有键、保留双方独有键」逻辑完全相反。
2. 浅层合并限制：Ruby原生Hash#merge仅处理顶层键，嵌套哈希会被直接替换，不会递归合并内部的键值对，导致Description这类嵌套结构丢失原有模板的键。
3. 数组处理缺陷：即使使用Rails提供的deep_merge（递归合并哈希），默认也会直接替换数组，无法保留模板中Steps里的RecipientType这类独有关键。

解决方案 #

1. 基础纠正：调整合并顺序（仅处理顶层键）

如果只需要处理顶层键的合并，直接调换合并顺序即可：

test = template_hash.merge(first_hash)

此方法会让顶层共有键（如Ids）取first_hash的值，同时保留双方独有的顶层键，但无法处理嵌套哈希的合并。

2. 嵌套哈希合并：使用Rails的deep_merge

Rails为Hash扩展了deep_merge方法，可递归合并所有层级的哈希：

test = template_hash.deep_merge(first_hash)

该方法会保留所有层级的独有键，共有键优先取first_hash的值，但默认会直接替换数组，导致模板中Steps的RecipientType丢失。

3. 自定义递归合并（处理数组内的哈希元素）

如果需要合并数组内的对应哈希元素（如按OrderIndex匹配Steps并合并Recipients），需编写自定义方法：

def deep_merge_with_array_sync(target, source)
  target.merge(source) do |key, old_val, new_val|
    if old_val.is_a?(Hash) && new_val.is_a?(Hash)
      deep_merge_with_array_sync(old_val, new_val)
    elsif old_val.is_a?(Array) && new_val.is_a?(Array)
      merged_array = old_val.dup
      new_val.each do |new_item|
        if new_item.is_a?(Hash) && new_item['OrderIndex']
          # 按OrderIndex匹配数组中的哈希元素并合并
          match_index = merged_array.find_index { |item| item['OrderIndex'] == new_item['OrderIndex'] }
          if match_index
            merged_array[match_index] = deep_merge_with_array_sync(merged_array[match_index], new_item)
          else
            merged_array << new_item
          end
        else
          merged_array << new_item unless merged_array.include?(new_item)
        end
      end
      merged_array
    else
      new_val # 非哈希/数组类型，用source的值覆盖
    end
  end
end

# 调用方法
test = deep_merge_with_array_sync(template_hash, first_hash)

此方法会：

• 递归合并所有层级的哈希
• 按OrderIndex匹配数组内的哈希元素并合并，而非直接替换数组
• 非哈希/数组元素优先使用first_hash的值

预期结果验证 #

使用上述自定义方法后，会得到你需要的结果：

• Ids取first_hash的值
• Description保留模板的Name、Subject、Finish，同时加入first_hash的Url、EventCallback
• Steps中的Recipients被first_hash的值覆盖，且保留模板的RecipientType

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