【笔记】ComfyUI “OSError: [WinError 38] 已到文件结尾” 报错解决方案

love530love

1266人浏览 · 2025-12-25 20:09:48

love530love · 2025-12-25 20:09:48 发布

ComfyUI “OSError: [WinError 38] 已到文件结尾” 报错解决方案

ComfyUI version: v0.6.0

错误现象

运行过程中（通常在预览视频、音频或大图时）控制台报错：

Traceback (most recent call last):
File “H:\PythonProjects1\Win_ComfyUI.venv\Lib\site-packages\aiohttp\web_protocol.py”, line 602, in start
resp, reset = await task
^^^^^^^^^^
File “H:\PythonProjects1\Win_ComfyUI.venv\Lib\site-packages\aiohttp\web_protocol.py”, line 535, in _handle_request
resp, reset = await self.finish_response(request, resp, start_time)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File “H:\PythonProjects1\Win_ComfyUI.venv\Lib\site-packages\aiohttp\web_protocol.py”, line 713, in finish_response
await prepare_meth(request)
File “H:\PythonProjects1\Win_ComfyUI.venv\Lib\site-packages\aiohttp\web_fileresponse.py”, line 288, in prepare
return await self._prepare_open_file(request, fobj, st, file_encoding)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File “H:\PythonProjects1\Win_ComfyUI.venv\Lib\site-packages\aiohttp\web_fileresponse.py”, line 418, in _prepare_open_file
return await self._sendfile(request, fobj, offset, count)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File “H:\PythonProjects1\Win_ComfyUI.venv\Lib\site-packages\aiohttp\web_fileresponse.py”, line 147, in _sendfile
await loop.sendfile(transport, fobj, offset, count)
File “D:\A\envs\py312\Lib\asyncio\base_events.py”, line 1232, in sendfile
return await self._sendfile_native(transport, file,
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File “D:\A\envs\py312\Lib\asyncio\proactor_events.py”, line 768, in _sendfile_native
return await self.sock_sendfile(transp._sock, file, offset, count,
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File “D:\A\envs\py312\Lib\asyncio\base_events.py”, line 919, in sock_sendfile
return await self._sock_sendfile_native(sock, file,
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File “D:\A\envs\py312\Lib\asyncio\proactor_events.py”, line 756, in _sock_sendfile_native
await self._proactor.sendfile(sock, file, offset, blocksize)
File “D:\A\envs\py312\Lib\asyncio\windows_events.py”, line 803, in _poll
value = callback(transferred, key, ov)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File “D:\A\envs\py312\Lib\asyncio\windows_events.py”, line 462, in finish_socket_func
return ov.getresult()
^^^^^^^^^^^^^^
OSError: [WinError 38] 已到文件结尾。

关键报错信息：

**OSError: [WinError 38] 已到文件结尾。**

Traceback 指向 aiohttp 的 sendfile 调用链（web_fileresponse.py → proactor_events.py）。

在这里插入图片描述

错误本质

Windows 系统下 asyncio 的 sendfile 在发送静态文件（output 中的 mp4、wav、长图等）时出现问题：

文件刚生成完，句柄尚未完全释放。
文件被杀毒软件/云盘同步工具短暂锁定。
大文件或低内存环境下 Windows proactor 实现不稳定。

重要：该错误仅影响浏览器实时预览，图片/视频/音频文件本身生成正常（output 文件夹里完整可用）。

解决方案（按推荐顺序）

最简单：直接忽略
生成结果不受影响，手动去 ComfyUI\output 文件夹查看文件即可。很多用户长期如此使用。
避免触发
- 使用 VHS_VideoCombine 等节点时，勾选 “skip video/audio preview” 或不连接预览节点。
- 生成后手动刷新 output 文件夹。
排除外部干扰
- 将 ComfyUI 整个文件夹（尤其是 output 子文件夹）加入杀毒软件（360、火绒、Windows Defender）白名单。
- 暂停 OneDrive、百度网盘、Dropbox 等对 output 文件夹的实时同步/扫描。
禁用 sendfile（推荐永久修复）
设置环境变量 AIOHTTP_NOSENDFILE=1，强制 aiohttp 使用普通 read/write 发送文件（速度略慢，几乎无感知）。

永久设置方法（一次设置，长期有效）：
- 打开命令提示符（建议管理员权限）：
```
setx AIOHTTP_NOSENDFILE "1"
```
  （普通用户级，推荐）
  或
```
setx AIOHTTP_NOSENDFILE "1" /M
```
  （系统级，需要管理员权限）
- 设置成功后提示 SUCCESS: Specified value was saved.
- 必须完全关闭并重启：
  - 关闭所有 cmd/PowerShell 窗口
  - 完全退出 PyCharm（包括托盘）
  - 重新启动 ComfyUI
- 验证：
```
echo %AIOHTTP_NOSENDFILE%
```
  输出应为 1
临时设置方法（测试用）：
- 在启动 bat 文件最上方添加：
```
set AIOHTTP_NOSENDFILE=1
```
- 或 PyCharm Run Configuration → Environment variables 添加该变量。