XlsxWriter生成Excel文件报错问题分析与解决方案

问题现象

在使用Python的XlsxWriter库生成Excel文件时，用户遇到了文件损坏无法打开的问题。具体表现为：

1. 通过Django视图生成的.xlsx文件下载后无法正常打开
2. LibreOffice提示"文件已损坏"
3. 文件在Google Sheets中也无法加载

环境信息

• Python版本：3.8.13（Docker容器内）/3.11.6（本地）
• XlsxWriter版本：3.2.0
• 操作系统：Ubuntu 20.04/22.04
• 办公软件：LibreOffice 7.6

问题排查过程

初步验证

用户首先尝试了XlsxWriter官方文档中的基础示例代码，确认在本地Python环境中可以正常生成和打开Excel文件。这表明XlsxWriter库本身的功能是正常的。

Django集成测试

在Django环境中使用时出现问题，主要表现特征为：

1. 文件能被下载但无法打开
2. LibreOffice错误地将文件识别为文本文件
3. 文件头显示为"PK"（正常的zip/xlsx文件签名）

关键发现

通过深入分析，发现问题的根源在于前端Axios请求的配置。前端在请求Excel文件时没有设置正确的responseType参数，导致二进制文件被错误地处理为文本。

解决方案

前端配置修正

在前端Axios请求中，必须明确指定responseType为'blob'：

axios.get('/api/export_xlsx', {
  responseType: 'blob'  // 关键配置
})

后端代码优化

虽然原始的后端代码基本正确，但可以做一些改进：

1. 确保使用BytesIO处理二进制数据
2. 正确设置HTTP响应头
3. 在关闭workbook后重置流指针

优化后的Django视图示例：

from io import BytesIO
import xlsxwriter
from django.http import HttpResponse

def export_xlsx(request):
    output = BytesIO()
    
    # 创建workbook时建议移除in_memory选项（默认即为True）
    workbook = xlsxwriter.Workbook(output)
    worksheet = workbook.add_worksheet()
    
    # 写入数据
    data = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]
    for row_num, columns in enumerate(data):
        for col_num, cell_data in enumerate(columns):
            worksheet.write(row_num, col_num, cell_data)
    
    workbook.close()
    output.seek(0)
    
    response = HttpResponse(
        output.getvalue(),  # 使用getvalue()确保获取全部数据
        content_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
    )
    response['Content-Disposition'] = 'attachment; filename="report.xlsx"'
    return response

经验总结

1. 二进制文件处理：Web应用中处理二进制文件时，必须确保前后端都使用正确的数据格式。前端需要明确指定接收的是二进制数据。

2. 流处理注意事项：使用BytesIO等内存流时，要注意指针位置。在读取前需要调用seek(0)重置指针。

3. 内容类型设置：HTTP响应头中的Content-Type必须准确对应文件类型，对于xlsx文件应使用特定的MIME类型。

4. 跨环境测试：在容器化环境中开发时，要注意与本地环境的差异，特别是文件编码和二进制处理方面。

扩展建议

对于生产环境中的Excel导出功能，还可以考虑以下优化：

1. 添加错误处理机制，捕获可能的IO异常
2. 实现分块传输大文件，减少内存消耗
3. 添加进度提示，改善用户体验
4. 考虑使用临时文件而非完全内存处理，避免内存溢出风险