使用Python xlrd库的dump_range方法时遇到"Workbook is encrypted"错误怎么解决？

问题现象与背景

当开发者使用Python的xlrd库处理Excel文件时，调用dump_range()方法可能遭遇"Workbook is encrypted"错误。这种情况通常发生在尝试读取受密码保护的.xlsx或.xls文件时，xlrd从2.0版本开始不再支持加密工作簿的直接读取。

错误发生的深层原因

xlrd库的加密文件处理限制源于其底层设计决策。版本迭代过程中，开发团队移除了对加密文件的默认支持能力，主要原因包括：

加密算法兼容性问题：不同Excel版本使用不同的加密标准
性能优化考虑：解密处理会显著增加内存消耗
安全合规要求：避免潜在的密码破解法律风险

六种实用解决方案

1. 使用原始密码解密文件

import xlrd
from xlrd import open_workbook

try:
    book = open_workbook("protected.xlsx", password="your_password")
    sheet = book.sheet_by_index(0)
    print(sheet.dump_range(0, 0, 5, 5))
except xlrd.XLRDError as e:
    print(f"解密失败: {str(e)}")

2. 转换为临时未加密文件

使用pywin32或openpyxl等支持解密的库先处理文件：

from openpyxl import load_workbook

wb = load_workbook(filename='encrypted.xlsx', read_only=True, keep_vba=False)
wb.save('temp_unprotected.xlsx')

3. 降级xlrd到1.2.0版本

早期版本对加密支持更友好：

pip uninstall xlrd
pip install xlrd==1.2.0

4. 使用商业库解决方案

考虑aspose-cells或spreadsheet等商业库，它们提供完整的加密支持。

5. 命令行预处理方案

通过LibreOffice进行批量解密：

soffice --headless --convert-to xlsx *.xls --password=your_pwd

6. 内存解密技术

使用msoffcrypto-tool实现内存级解密：

import msoffcrypto
import io

decrypted = io.BytesIO()
with open("encrypted.xlsx", "rb") as f:
    office_file = msoffcrypto.OfficeFile(f)
    office_file.load_key(password="password")
    office_file.decrypt(decrypted)

book = xlrd.open_workbook(file_contents=decrypted.getvalue())

性能与安全性对比

方案	执行速度	内存占用	安全性
原始密码解密	快	低	高
临时文件转换	慢	高	中
版本降级	最快	最低	低

最佳实践建议

根据实际场景需求选择合适方案：

开发环境优先考虑内存解密方案
生产环境建议采用商业库确保稳定性
批量处理时使用命令行工具提高效率

特别注意：处理加密电子表格时需遵守数据保护法规，确保有合法的文件访问权限。