Jupyter Lab无法访问Windows OneDrive目录的问题求助

Windows 10机器安装Python 3.11，公司OneDrive同步运行，Jupyter Lab文件存储于OneDrive文件夹。创建文件夹使用一段时间后，无法通过Jupyter Lab浏览器界面访问该文件夹——可通过Windows资源管理器正常访问，但Jupyter Lab中访问会抛出错误。将文件夹内容移至新文件夹可暂时解决，但一段时间后错误复现。

环境版本 #

• Jupyter Lab - 3.6.3
• Python - 3.11
• Windows 10 - 10.0.19045
• OneDrive - Build 23.101.0514.0004
• Chrome - 116.0.5845.188

错误日志 #

To access the server, open this file in a browser:
    file:///C:/Users/user1234/AppData/Roaming/jupyter/runtime/jpserver-19500-open.html
Or copy and paste one of these URLs:
    http://localhost:8888/lab?token=43e123456e503de90628c8c74ff16eb5a2e4c96d3d21dd0
    http://127.0.0.1:8888/lab?token=43e123456e503de90628c8c74ff16eb5a2e4c96d3d21dd0

0.00s - Debugger warning: It seems that frozen modules are being used, which may
0.00s - make the debugger miss breakpoints. Please pass -Xfrozen_modules=off
0.00s - to python to disable frozen modules.
0.00s - Note: Debugging will proceed. Set PYDEVD_DISABLE_FILE_VALIDATION=1 to disable this validation.
[W 2023-09-14 12:15:53.418 LabApp] Could not determine jupyterlab build status without nodejs
[E 2023-09-14 12:16:10.988 ServerApp] Uncaught exception GET /api/contents/OneDrive%20-%20Company/new_jupyter/mbm_it_time_tracking_mirgation_2?content=1&1694708170983 (::1)
HTTPServerRequest(protocol='http', host='localhost:8888', method='GET', uri='/api/contents/OneDrive%20-%20Company/new_jupyter/mbm_it_time_tracking_mirgation_2?content=1&1694708170983', version='HTTP/1.1', remote_ip='::1')
Traceback (most recent call last):
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\tornado\web.py", line 1769, in execute
result = await result
^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\jupyter_server\services\contents\handlers.py", line 121, in get
model = await ensure_async(
^^^^^^^^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\jupyter_core\utils_init.py", line 182, in ensure_async
result = await obj
^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\jupyter_server\services\contents\filemanager.py", line 887, in get
model = await self._dir_model(path, content=content)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\jupyter_server\services\contents\filemanager.py", line 754, in _dir_model
dir_contents = await run_sync(os.listdir, os_dir)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\anyio\to_thread.py", line 31, in run_sync
return await get_asynclib().run_sync_in_worker_thread(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\anyio_backends_asyncio.py", line 937, in run_sync_in_worker_thread
return await future
^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\anyio_backends_asyncio.py", line 867, in run
result = context.run(func, args)
^^^^^^^^^^^^^^^^^^^^^^^^
OSError: [WinError 87] 参数不正确: 'c:\Users\user1234\OneDrive - Company\new_jupyter\mbm_it_time_tracking_mirgation_2'
[W 2023-09-14 12:16:10.995 ServerApp] wrote error: 'Unhandled error'
Traceback (most recent call last):
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\tornado\web.py", line 1769, in execute
result = await result
^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\jupyter_server\services\contents\handlers.py", line 121, in get
model = await ensure_async(
^^^^^^^^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\jupyter_core\utils_init.py", line 182, in ensure_async
result = await obj
^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\jupyter_server\services\contents\filemanager.py", line 887, in get
model = await self._dir_model(path, content=content)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\jupyter_server\services\contents\filemanager.py", line 754, in _dir_model
dir_contents = await run_sync(os.listdir, os_dir)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\anyio\to_thread.py", line 31, in run_sync
return await get_asynclib().run_sync_in_worker_thread(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\anyio_backends_asyncio.py", line 937, in run_sync_in_worker_thread
return await future
^^^^^^^^^^^^
File "C:\Users\user1234\AppData\Local\Programs\Python\Python311\Lib\site-packages\anyio_backends_asyncio.py", line 867, in run
result = context.run(func, args)
^^^^^^^^^^^^^^^^^^^^^^^^
OSError: [WinError 87] 参数不正确: 'c:\Users\user1234\OneDrive - Company\new_jupyter\mbm_it_time_tracking_mirgation_2'
[E 2023-09-14 12:16:10.999 ServerApp] {
"Host": "localhost:8888",
"Accept": "/",
"Referer": "http://localhost:8888/lab",
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36"
}
[E 2023-09-14 12:16:11.013 ServerApp] 500 GET /api/contents/OneDrive%20-%20Company/new_jupyter/mbm_it_time_tracking_mirgation_2?content=1&1694708170983 (86a3026ace8a4fd995b0658528bbc2e9@::1) 14.00ms referer=http://localhost:8888/lab

## 原因分析
1. **OneDrive同步冲突或文件系统标记异常**：OneDrive在同步过程中可能给文件/文件夹添加特殊标记、锁定资源，或残留临时文件，导致Python的`os.listdir`无法正常读取目录。
2. **路径转义问题**：日志中路径包含`\new_jupyter`，其中`\n`在Python字符串中是换行符，可能存在路径转义错误，导致Jupyter Lab解析路径时出现参数错误。
3. **OneDrive的Files On-Demand功能干扰**：若开启该功能，文件夹可能仅为占位符而非本地完全同步，Jupyter Lab访问时无法正确读取实际文件。
4. **权限或文件系统缓存问题**：Windows系统的文件权限缓存、OneDrive的同步权限冲突，导致Jupyter进程无法访问目录内容。

## 修复方案
### 临时修复（快速恢复访问）
- **重命名问题文件夹**：直接给文件夹重命名（比如在末尾加数字），再尝试在Jupyter Lab中访问，避免路径转义或标记问题。
- **手动同步OneDrive**：右键点击任务栏OneDrive图标，选择“同步全部”，等待同步完成后重启Jupyter Lab。

### 持久化解决方案
1. **关闭OneDrive Files On-Demand**
   - 打开OneDrive设置 → 账户 → 选择“设置” → 取消勾选“节省空间并下载你使用的文件”，确保所有文件本地同步完成后再使用Jupyter Lab。
2. **修改Jupyter Lab启动路径为本地非OneDrive目录**
   - 打开命令提示符，切换到本地非OneDrive文件夹（比如`cd C:\Users\user1234\Documents\Jupyter`），然后运行`jupyter lab`启动，规避OneDrive同步干扰。
3. **修复路径转义问题**
   - 生成Jupyter Lab配置文件：运行`jupyter server --generate-config`。
   - 打开生成的`jupyter_server_config.py`，找到`c.ServerApp.root_dir`，设置为本地目录的绝对路径（使用双反斜杠`\\`或正斜杠`/`），示例：
     ```python
     c.ServerApp.root_dir = 'C:/Users/user1234/OneDrive - Company/new_jupyter'
     ```
   - 保存配置后重启Jupyter Lab，确保路径解析正确。
4. **重置OneDrive同步缓存**
   - 右键任务栏OneDrive图标 → 设置 → 账户 → 选择“取消链接此PC”，重新登录并同步所有文件，清除可能的同步缓存和异常标记。
5. **更新相关软件版本**
   - 更新Jupyter Lab到最新稳定版：运行`pip install --upgrade jupyterlab`；更新OneDrive到最新版本，修复已知兼容性问题。

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