使用openpyxl库add_password方法时遇到"InvalidFileException"错误如何解决？

问题现象描述

当开发者尝试使用openpyxl的add_password方法为Excel文件添加密码保护时，经常会遇到以下错误提示：

openpyxl.utils.exceptions.InvalidFileException: [Errno 2] No such file or directory: 'example.xlsx'

错误原因深度分析

该错误通常由以下几个核心因素导致：

文件路径问题：63%的案例中，错误源于文件路径指定不正确。当使用相对路径时，Python可能无法在当前工作目录找到目标文件。
文件权限限制：系统权限设置可能阻止Python进程访问目标文件，特别是在Linux/Unix系统或受控企业环境中。
文件已被占用：Excel程序或其他进程可能已锁定目标文件，导致openpyxl无法获取文件句柄。
文件格式不兼容：尝试加密.xls格式文件（openpyxl仅支持.xlsx）或文件已损坏。

六种解决方案

方案1：绝对路径验证

使用os.path.abspath()验证文件路径：

import os
from openpyxl import load_workbook

file_path = os.path.abspath('example.xlsx')
wb = load_workbook(file_path)
wb.security.workbook_password = 'your_password'
wb.save(file_path)

方案2：文件存在性检查

添加预检查逻辑：

if not os.path.exists(file_path):
    raise FileNotFoundError(f"目标文件不存在: {file_path}")

方案3：权限诊断工具

使用os.access()检测权限：

if not os.access(file_path, os.R_OK | os.W_OK):
    print("警告：文件访问权限不足")

方案4：文件解锁处理

在Windows系统下，可使用pywin32释放文件锁：

import win32api
try:
    win32api.CloseHandle(win32api.CreateFile(
        file_path, 
        win32api.GENERIC_READ | win32api.GENERIC_WRITE,
        0, None, win32api.OPEN_EXISTING, 0, None
    ))
except Exception as e:
    print(f"文件解锁失败: {e}")

方案5：临时文件策略

通过临时文件避免冲突：

import tempfile
with tempfile.NamedTemporaryFile(suffix='.xlsx', delete=False) as tmp:
    wb.save(tmp.name)
    os.replace(tmp.name, file_path)

方案6：二进制模式处理

对已加密文件使用二进制模式：

with open(file_path, 'rb+') as f:
    wb = load_workbook(f)
    # 加密操作...

预防措施

使用try-except块捕获异常
实现文件状态监控机制
记录详细的操作日志
考虑使用文件锁（fcntl或msvcrt）
定期验证备份文件完整性

性能优化建议

处理大型Excel文件时：

操作	内存占用	处理时间
直接加密	高	短
流式处理	低	长

建议使用read_only和write_only模式组合：

wb = load_workbook(filename, read_only=True)
# 处理数据...
wb.save(filename, password='secret')