Pandas报错‘Columns must be same length as key’：返回元素匹配仍报错

可能的原因 #

• getPlayerBasicInfo函数并非对所有行都返回长度为3的可迭代对象：比如部分球员请求失败时返回了None、单个值或长度不足3的列表/元组，导致apply后的结果整体结构混乱，无法匹配目标列的数量。
• 函数返回的结构不符合要求：比如返回的是字符串、字典而非元组/列表这类可被展开的结构，或者返回的是Series但索引不匹配，导致apply无法正确拆分到多列。
• 存在异常行未处理：比如网络请求超时、网页解析失败时，函数未捕获异常，抛出的错误导致该行返回异常值，破坏了整体结果的长度一致性。

解决办法 #

1. 确保函数稳定返回长度为3的可迭代对象 #

给函数添加异常处理，保证无论请求成功与否都返回三元组：

import pandas as pd

def getPlayerBasicInfo(row):
    player_name = row['Player']
    try:
        # 你的POST请求逻辑，获取url、role、team
        # 示例逻辑：
        # response = requests.post(...)
        # 解析response得到url, role, team
        url = f"https://example.com/players/{player_name}"
        role = "Batsman"
        team = "XYZ Warriors"
        return (url, role, team)  # 必须返回长度为3的元组/列表
    except Exception as e:
        print(f"处理球员 {player_name} 出错: {str(e)}")
        return ("", "", "")  # 出错时返回空值三元组

2. 使用result_type='expand'参数强制展开结果 #

调用apply时指定result_type='expand'，让Pandas自动将每行的返回值展开为多列：

# 生成结果DataFrame
result_df = testdf.apply(getPlayerBasicInfo, axis='columns', result_type='expand')
# 赋值到原DataFrame
testdf[['URL', 'Role', 'Team']] = result_df

3. 让函数返回Series（替代方案） #

修改函数返回Series并指定列名，这样apply后直接得到匹配结构的结果：

def getPlayerBasicInfo(row):
    player_name = row['Player']
    try:
        # 请求逻辑...
        url = f"https://example.com/players/{player_name}"
        role = "Batsman"
        team = "XYZ Warriors"
        return pd.Series([url, role, team], index=['URL', 'Role', 'Team'])
    except Exception as e:
        print(f"处理球员 {player_name} 出错: {str(e)}")
        return pd.Series(["", "", ""], index=['URL', 'Role', 'Team'])

# 直接赋值
testdf[['URL', 'Role', 'Team']] = testdf.apply(getPlayerBasicInfo, axis='columns')

4. 排查异常行 #

如果不确定哪行出问题，可以先单独测试函数对每个球员的返回：

# 遍历所有球员，检查函数返回
for idx, row in testdf.iterrows():
    res = getPlayerBasicInfo(row)
    if len(res) != 3:
        print(f"第{idx}行球员 {row['Player']} 返回异常: {res}")

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