合并带UTC时区与无时区空DataFrame报错的根源排查与解决

根本原因 #

• 合并非空带时区DataFrame时，Pandas会通过实际数据自动完成类型兼容：将无时区的datetime64[ns]列隐式转换为带UTC时区的datetime64[ns, UTC]类型，因此合并流程正常。
• 合并空带时区DataFrame时，由于没有实际数据可供类型推断，Pandas会严格校验列的原始数据类型，发现timestamp列的时区属性不匹配（一个无时区、一个带UTC时区），直接抛出合并错误。

源头解决方案 #

方案1：初始化结果表时统一时区类型 #

直接在创建result_table和result_table2时，将timestamp列设置为带UTC时区的类型，从根源上保证类型一致：

import pandas as pd

# 初始化带UTC时区的空结果表
result_table = pd.DataFrame(columns=['timestamp'])
result_table['timestamp'] = pd.to_datetime(result_table['timestamp'], utc=True)

result_table2 = pd.DataFrame(columns=['timestamp'])
result_table2['timestamp'] = pd.to_datetime(result_table2['timestamp'], utc=True)

方案2：合并前强制对齐时区（适合无法修改初始表的场景） #

如果无法修改结果表的初始类型，可在合并前将无时区的timestamp列转换为UTC时区类型：

# 合并前将结果表的timestamp列转为UTC时区
result_table['timestamp'] = result_table['timestamp'].dt.tz_localize('UTC')
result_table2['timestamp'] = result_table2['timestamp'].dt.tz_localize('UTC')

# 执行合并操作
result_table = result_table.merge(df1_utc, on="timestamp", how='outer')
result_table2 = result_table2.merge(empty_df2_utc, on="timestamp", how='outer')

验证效果 #

修改后重新运行复现代码，两种合并场景（非空/空DataFrame）都能正常执行，不会再抛出时区不匹配错误。

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