Pandas复合唯一键合并报错：列标签非唯一及多索引疑问

错误根源：DataFrame列索引创建错误 #

你遇到的merge报错，本质是创建DataFrame时列名参数用错了，和复合键是否唯一无关。

具体分析 #

• 你写的columns=data1[:1]，data1[:1]返回的是[['date', 'symbol', 'value']]——这是一个嵌套的二维列表。pandas会把这种格式的参数解析成多级列索引（MultiIndex），最终df1和df2的列名会变成('date',)、('symbol',)、('value',)这种单元素元组。
• 执行merge时，你传入的on=['date', 'symbol']是普通字符串，但实际列名是元组类型的多级索引。pandas无法用字符串匹配元组列名，就抛出了错误：提示列标签'date'不唯一，同时说明对于多级索引，必须用对应层级的元组来指定列名（这就是错误信息里多索引描述的由来，你的DataFrame确实是多级列索引，不是默认索引的问题）。

修复代码 #

把创建DataFrame时的columns=data1[:1]改成columns=data1[0]（直接取表头行的一维列表）：

import pandas as pd

data1 = [['date'  ,    'symbol', 'value'],
         ['1999-01-10', 'AAA',      101],
         ['1999-01-11', 'AAA',      201]]

data2 = [['date'  ,    'symbol', 'value'],
         ['1999-01-10', 'BBB',      101],
         ['1999-01-11', 'BBB',      201]]

# 修正columns参数为一维表头列表
df1 = pd.DataFrame(data1[1:], columns=data1[0])
df2 = pd.DataFrame(data2[1:], columns=data2[0])
df = df1.merge(df2, on=['date', 'symbol'], how='outer')

修复后，列名是普通字符串，merge可以正常执行，最终得到4行数据（两个DataFrame的date+symbol组合无重叠，outer join后行数直接相加）。

关于pd.concat的补充 #

你用pd.concat能实现需求，是因为它默认按行拼接（axis=0），只要两个DataFrame列名一致就能直接合并，刚好匹配你“列数相同、行数增加”的需求。但如果之后需要基于特定键做匹配合并（比如存在重叠键需要关联），merge仍是更合适的工具，只要确保列名格式正确即可。

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