Python跨文件调用方法循环操作时报WinError32 文件被占用无法删除

核心原因 #

Windows 平台下文件操作依赖独占锁机制，该报错本质是执行os.remove时，待删除的pdf_file_path对应的文件，被未释放的文件句柄占用。
两种运行场景的差异来源于句柄释放时机的不同：独立模块运行时，代码线性紧凑执行，GC 回收和系统句柄释放即时完成；封装为方法被外部文件调用时，上游调用链的文件操作句柄尚未释放，就进入了循环内的删除逻辑，因此触发冲突。

常见触发场景 #

• 上游 PDF 解析/生成逻辑未显式释放句柄：比如用 PyPDF2、pdfplumber、reportlab 等库处理 PDF 时，打开的文件对象没有关闭，仅依赖 Python GC 自动回收，而被调用场景下 GC 尚未触发回收，句柄仍处于占用状态。
• 循环内复用文件对象变量：上一次循环生成的 PDF 文件对象未超出作用域，被新的循环值覆盖前，旧句柄尚未释放，就触发了上一轮文件的删除操作。
• shutil.copy 执行后未等待系统完成文件流校验：Windows 下小概率出现源文件的读取流还未完全释放，就触发了源文件删除的冲突。

解决方案 #

1. 强制用上下文管理器释放文件句柄 #

所有涉及 PDF 读写的逻辑必须替换为 with 上下文管理写法，出代码块后自动释放系统句柄，禁止依赖 GC 回收：

# PDF 读取示例
import pdfplumber
with pdfplumber.open(pdf_file_path) as pdf:
    # 执行解析逻辑
    pass

# 通用文件读写示例
with open(pdf_file_path, 'rb') as f:
    # 执行文件操作
    pass

如果使用的旧版本库不支持上下文管理器，必须在操作完成后手动调用文件对象的 close() 方法：

reader = PyPDF2.PdfReader(pdf_file_path)
# 执行解析逻辑
reader.stream.close()

2. 给文件删除操作增加重试容错 #

Windows 下句柄释放存在微小的系统延迟，可对删除操作增加有限次重试，避免临时占用触发报错：

import time
import os

def safe_remove(file_path, max_retry=5, interval=0.5):
    if not os.path.isfile(file_path):
        return
    for _ in range(max_retry):
        try:
            os.remove(file_path)
            return
        except PermissionError:
            time.sleep(interval)
    raise PermissionError(f"文件多次重试后仍无法删除：{file_path}")

将原循环内的os.remove(pdf_file_path)替换为上述safe_remove(pdf_file_path)即可。

3. 定位异常占用句柄 #

如果上述操作仍报错，可通过 Windows 资源监视器定位占用进程：打开资源监视器，切换到「CPU」标签页，在「关联的句柄」搜索框中输入报错的 PDF 文件名，即可定位到持有句柄的具体进程，进一步对应到代码中未释放的逻辑。

内容的提问来源于stack exchange，提问作者Yogaraj Muthupandian M.C.A