os.walk(onerror)参数使用咨询：如何捕获listdir()错误并获取路径

嘿，我之前也琢磨过这个问题，刚好能给你讲明白os.walk的onerror参数怎么玩～

先搞懂onerror的工作逻辑 #

os.walk的onerror本质是个回调钩子：当它调用listdir()或者stat()遇到错误时（比如权限不够、目录突然消失），就会把错误信息传给你指定的回调函数。默认没设置这个参数的话，错误就直接被忽略了，这就是你看不到报错的原因。

实现错误提醒+获取出错目录的具体代码 #

你需要自己写一个回调函数，这个函数必须能接收三个参数：

• 第一个是错误对象（比如OSError、PermissionError这类实例）
• 第二个是触发错误的路径（也就是你要的出错目录）
• 第三个是异常的追踪信息（一般用不上，但函数必须接收它）

基础版：直接打印错误信息 #

import os

def walk_error_handler(error, err_path, exc_info):
    # 打印错误详情和对应的目录
    print(f"⚠️ 遍历出错: {error}")
    print(f"出错目录: {err_path}")
    # 如果想遇到错误就终止遍历，取消下面这行注释
    # raise error

# 调用os.walk时传入onerror参数
for root, dirs, files in os.walk("/你要遍历的目录", onerror=walk_error_handler):
    # 这里写你的正常遍历逻辑
    print(f"正在遍历: {root}")

进阶版：收集所有错误后续处理 #

如果想把所有错误存起来统一查看，可以用列表收集：

import os

# 用来存错误的列表，每个元素是(出错目录, 错误信息)
error_records = []

def collect_walk_errors(error, err_path, exc_info):
    error_records.append( (err_path, str(error)) )

# 执行遍历
for root, dirs, files in os.walk("/目标目录", onerror=collect_walk_errors):
    # 正常处理文件/目录逻辑
    pass

# 遍历结束后查看所有错误
print("\n📝 遍历过程中遇到的所有错误:")
for path, msg in error_records:
    print(f"目录 {path}: {msg}")

几个要注意的点 #

• 回调函数必须接收三个参数，哪怕后面两个用不到，不然会触发参数不匹配的错误
• 如果在回调里raise error，os.walk会立刻终止遍历；不抛出的话，遍历会继续处理其他目录
• 可以根据错误类型做针对性处理，比如判断isinstance(error, PermissionError)时单独记录权限问题

内容的提问来源于stack exchange，提问作者Ján Hanes