如何用Python检测OneDrive仅在线文件？解决脚本遍历崩溃问题

一、判断文件是仅在线还是已下载 #

OneDrive在Windows和macOS平台的文件状态标记机制不同，需分别处理：

Windows平台 #

通过NTFS文件属性判断，仅在线文件带有FILE_ATTRIBUTE_OFFLINE标记。使用pywin32库读取属性：

1. 安装依赖：

pip install pywin32

2. 判断函数：

import win32api
import win32file

def is_onedrive_file_online(file_path):
    try:
        attrs = win32api.GetFileAttributes(file_path)
        # 存在OFFLINE属性则为仅在线文件
        return (attrs & win32file.FILE_ATTRIBUTE_OFFLINE) != 0
    except Exception as e:
        print(f"读取文件属性失败: {e}")
        return False

返回True表示文件仅在线，False表示已下载或本地文件。

macOS平台 #

通过扩展属性com.microsoft.OneDrive.FetchStatus判断，值为1是仅在线，0是已下载。使用xattr库读取：

1. 安装依赖：

pip install xattr

2. 判断函数：

import xattr

def is_onedrive_file_online(file_path):
    try:
        fetch_status = xattr.getxattr(file_path, "com.microsoft.OneDrive.FetchStatus")
        return int(fetch_status) == 1
    except xattr.XAttrError:
        # 无该属性说明是本地文件或非OneDrive文件
        return False
    except Exception as e:
        print(f"读取文件属性失败: {e}")
        return False

二、解决遍历崩溃问题 #

遍历文件夹时，优先判断文件状态，避免因等待下载导致崩溃，有两种方案：

方案1：跳过仅在线文件 #

遍历过程中直接跳过未下载的文件，只处理已下载的：

import os

def traverse_onedrive_folder(folder_path):
    for root, _, files in os.walk(folder_path):
        for file in files:
            full_path = os.path.join(root, file)
            if is_onedrive_file_online(full_path):
                print(f"跳过仅在线文件: {full_path}")
                continue
            # 此处添加你的文件处理逻辑
            print(f"处理已下载文件: {full_path}")

方案2：可控下载仅在线文件 #

若必须处理未下载文件，可触发下载并设置超时，防止脚本卡住（以Windows为例）：

import win32file
import win32event

def download_onedrive_file(file_path, timeout=30):
    try:
        # 打开文件触发下载
        handle = win32file.CreateFile(
            file_path,
            win32file.GENERIC_READ,
            win32file.FILE_SHARE_READ | win32file.FILE_SHARE_WRITE,
            None,
            win32file.OPEN_EXISTING,
            win32file.FILE_ATTRIBUTE_NORMAL,
            None
        )
        # 等待下载完成，超时时间（秒）转毫秒
        result = win32event.WaitForSingleObject(handle, timeout * 1000)
        win32file.CloseHandle(handle)
        if result == win32event.WAIT_OBJECT_0:
            print(f"{file_path} 下载完成")
            return True
        else:
            print(f"{file_path} 下载超时")
            return False
    except Exception as e:
        print(f"下载{file_path}失败: {e}")
        return False

遍历调用时，超时则跳过该文件：

def traverse_with_download(folder_path):
    for root, _, files in os.walk(folder_path):
        for file in files:
            full_path = os.path.join(root, file)
            if is_onedrive_file_online(full_path):
                if not download_onedrive_file(full_path):
                    print(f"跳过未下载完成的文件: {full_path}")
                    continue
            # 处理文件逻辑
            print(f"处理文件: {full_path}")

注意事项 #

• 确保OneDrive客户端已登录并正常运行，否则属性读取可能失败。
• 不同版本的OneDrive可能存在属性差异，需根据自身版本测试适配。
• macOS下若OneDrive来自App Store，运行脚本需确保有读取扩展属性的权限。

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