递归搜索Outlook根目录指定文件夹返回空对象问题排查

问题根源 #

1. 示例代码存在函数名调用笔误
   你定义的递归查找函数名为findFolderRecursive，但调用时写的是findFolder（即你给出的非递归实现的函数名），如果实际运行代码也存在这个问题，会直接调用非递归函数，仅遍历当前目录的子文件夹，在目标文件夹嵌套层级不同的场景下就会出现有时能找到有时找不到的情况。
2. 递归函数的匹配逻辑有缺陷
   你写的递归是深度优先遍历整个邮箱的所有层级文件夹，只要碰到第一个名字匹配的文件夹就直接返回。如果你的邮箱里存在多个同名的Test Folder（比如一个在根目录，另一个嵌套在其他文件夹里是空的），递归很可能先匹配到那个空的同名文件夹，才会走到你要的目标文件夹。
   而你给出的非递归实现只会遍历传入目录的直接子文件夹，不会往下钻更深的层级，所以每次都能精准匹配到你要的根目录下的目标文件夹，自然不会拿到空对象。
3. 缺少全链路的空值校验
   不管是文件夹查找结果、获取到的最新邮件对象，都没有做空判断，只要某一步返回空值，后续调用就会直接抛出属性错误。
4. 递归遍历过程中可能碰到异常的Outlook文件夹对象
   win32com调用Outlook接口时，部分系统保留文件夹、没有访问权限的同步文件夹、损坏的缓存文件夹，可能会返回名称匹配但内部Items为空的无效对象，递归遍历的时候很容易误触这类对象。

修复方案 #

先修改递归查找函数，增加可选的层级限制，同时补全所有空值校验逻辑：

import win32com.client

EMAIL = "user.email@domain.com"
FOLDERNAME = "Test Folder"
# 可选：限制查找的最大深度，和非递归逻辑对齐的话设为1即可，不需要限制可设为10或更大数值
MAX_SEARCH_DEPTH = 1

outlook = win32com.client.Dispatch("Outlook.Application").GetNamespace("MAPI")
folderRoot = None
for folder in outlook.Folders:
    if folder.Name == EMAIL:
        folderRoot = folder
        break

def findFolderRecursive(folderName, directory, current_depth=0):
    if directory.Name == folderName:
        return directory
    # 超过最大查找深度就不再往下遍历
    if current_depth >= MAX_SEARCH_DEPTH:
        return None
    for folder in directory.Folders:
        result = findFolderRecursive(folderName, folder, current_depth+1)
        if result is not None:
            return result
    # 遍历完所有子文件夹都没找到，显式返回None
    return None

# 先校验文件夹是否找到
folder = findFolderRecursive(FOLDERNAME, folderRoot)
if not folder:
    raise ValueError(f"未找到名为{FOLDERNAME}的文件夹")

# 校验邮件列表不为空
items = folder.Items
if items.Count == 0:
    raise ValueError(f"文件夹{FOLDERNAME}中没有邮件")

# 取最新邮件后校验
latest = items.GetLast()
if not latest:
    raise ValueError("获取最新邮件失败")

# 校验附件存在
if latest.Attachments.Count == 0:
    raise ValueError("最新邮件没有附件")

report = latest.Attachments(1)

额外说明 #

如果你的目标文件夹确实在深层级，不需要限制查找深度，可以把MAX_SEARCH_DEPTH设为较大数值，或者直接去掉深度限制逻辑，提前把邮箱里的空同名文件夹改名即可。

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