Jupyter Notebook下载生成的Excel文件报网络错误及NoneType错误如何解决

错误根因 #

1. pandas的to_excel方法在指定本地文件路径作为参数时，会直接将内容写入磁盘，返回值为None，你尝试对None调用encode方法触发了报错。而to_csv在不指定路径时会直接返回CSV格式字符串，二者行为存在差异。
2. 直接使用本地文件名作为下载链接的href时，Jupyter服务端没有将工作目录文件映射为可访问的静态资源，所以会触发网络错误，和你之前CSV不加base64报错的原因一致。
3. Excel属于二进制文件，不能和文本格式的CSV一样直接做字符串编码，且对应的MIME类型不能用text/xls，要使用对应二进制格式的类型标识。

解决步骤 #

先确保安装xlsx处理依赖：

pip install openpyxl

完整可运行的Excel下载函数实现：

import base64
from io import BytesIO
from IPython.display import HTML

def func(df, title="Download excel file", filename="ABC.xlsx"):
    # 创建内存缓冲区存储Excel内容，不生成本地磁盘文件
    output = BytesIO()
    # 将DataFrame写入内存缓冲区
    df.to_excel(output, index=True, engine='openpyxl')
    # 读取缓冲区二进制内容做base64编码
    output.seek(0)
    b64 = base64.b64encode(output.read())
    payload = b64.decode()
    # 使用Excel正确的MIME类型构造下载链接
    html = f'<a href="data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64,{payload}" download="{filename}" target="_blank">{title}</a>'
    return HTML(html)

如果你使用的是带样式的Styler对象，只需要把df.to_excel替换为你的Styler对象调用to_excel方法即可，其余逻辑保持不变。

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