如何解决函数中调用os.walk触发StopIteration错误的问题？

StopIteration 错误触发的核心原因是os.walk(_root)返回的迭代器为空，调用next()时无元素可返回就会抛出该异常。绝大多数场景下该问题是你传入的_root路径不合法导致的：路径不存在、路径指向的不是目录、当前运行账号无该目录的读取权限都会导致os.walk无法遍历到任何内容。

• 首先打印路径的实际解析结果验证路径正确性：执行print(os.path.abspath(root))输出相对路径对应的绝对路径，确认该路径和你预期的目标目录一致。
• 校验路径合法性：分别执行print(os.path.exists(root))、print(os.path.isdir(root))，确认路径存在且为文件夹类型。
• 权限排查：如果路径合法，确认运行脚本的系统账号对该目录拥有读取权限。

1. 路径修正建议 #

尽量避免直接写多层相对路径，脚本运行时的工作目录发生变化会导致相对路径解析结果不符合预期，建议基于当前脚本所在路径拼接目标目录的绝对路径：

import os
# 获取当前脚本所在目录的绝对路径
script_dir = os.path.dirname(os.path.abspath(__file__))
# 拼接得到目标目录绝对路径，自动适配不同操作系统的路径分隔符
root = os.path.join(script_dir, "../../../Image/new_m/")
# 标准化路径消除多余的../字符
root = os.path.normpath(root)

2. 函数鲁棒性优化 #

给getFiles函数增加前置校验和异常捕获，避免直接抛出StopIteration错误：

def getFiles(_root):
    # 前置校验路径合法性
    if not os.path.exists(_root):
        raise FileNotFoundError(f"目标路径不存在：{_root}")
    if not os.path.isdir(_root):
        raise NotADirectoryError(f"目标路径不是文件夹：{_root}")
    try:
        return next(os.walk(_root))[2]
    except StopIteration:
        # 特殊场景下目录无法遍历则返回空列表
        return []

fileList = getFiles(root)
fileList = sorted(fileList)

内容的提问来源于stack exchange，提问作者SANYAM CHAURASIA