AttributeError: module ‘torch’ has no attribute ‘float8_e4m3fn’

快速结论：该报错通常出现在 Stable Diffusion WebUI Forge 启动阶段，导入 modules_forge/main_entry.py 时因当前 PyTorch 版本过旧、不包含 torch.float8_e4m3fn 而失败。优先排查并升级 Forge 实际使用的 venv 中的 PyTorch 版本。

适用环境：Windows；Stable Diffusion WebUI Forge 使用 COMMANDLINE_ARGS=--xformers --cuda-malloc --cuda-stream；显卡为 RTX 2060 6GB VRAM。Issue 中用户未使用 Forge 独立 venv，而是复用 A1111 的 venv 文件夹。

最快修复方案：进入 Forge 实际使用的 venv 环境后执行 pip install --upgrade torch torchvision torchaudio。Issue 评论中提出该方法“可能解决”问题，属可优先尝试方案，并非 Issue 中已验证的最终结果。

注意事项：torch.float8_e4m3fn 据 Issue 讨论仅从 PyTorch 2.1 及之后版本才提供。若 Forge 复用 A1111 的 venv，两者依赖需求可能存在差异，共用 venv 未必是最佳做法。Intel Arc 用户需注意自定义 IPEX/torch 构建的兼容性，Issue 中提到的 2.1.20+mtl+oneapi 构建为 CPU AOT 版本，首次推理可能极慢。

问题场景

用户在 Stable Diffusion WebUI Forge 中执行启动脚本，使用 --xformers --cuda-malloc --cuda-stream 参数运行 WebUI。程序在导入阶段进入 modules_forge/main_entry.py，读取 FP8 相关类型映射时触发异常，导致 WebUI 无法启动。

报错原文

Using xformers cross attention
Using xformers attention for VAE
Traceback (most recent call last):
  File "C:\Users\TUF\Desktop\Ai\A1111\launch.py", line 51, in <module>
    main()
  File "C:\Users\TUF\Desktop\Ai\A1111\launch.py", line 47, in main
    start()
  File "C:\Users\TUF\Desktop\Ai\A1111\modules\launch_utils.py", line 544, in start
    import webui
  File "C:\Users\TUF\Desktop\Ai\A1111\webui.py", line 21, in <module>
    initialize.imports()
  File "C:\Users\TUF\Desktop\Ai\A1111\modules\initialize.py", line 32, in imports
    from modules import processing, gradio_extensions, ui  # noqa: F401
  File "C:\Users\TUF\Desktop\Ai\A1111\modules\ui.py", line 16, in <module>
    from modules import sd_hijack, sd_models, script_callbacks, ui_extensions, deepbooru, extra_networks, ui_common, ui_postprocessing, progress, ui_loadsave, shared_items, ui_settings, timer, sysinfo, ui_checkpoint_merger, scripts, sd_samplers, processing, ui_extra_networks, ui_toprow, launch_utils
  File "C:\Users\TUF\Desktop\Ai\A1111\modules\ui_settings.py", line 10, in <module>
    from modules_forge import main_entry
  File "C:\Users\TUF\Desktop\Ai\A1111\modules_forge\main_entry.py", line 17, in <module>
    'fp8e4m3': torch.float8_e4m3fn,
AttributeError: module 'torch' has no attribute 'float8_e4m3fn'

原因分析

最可能的原因是当前环境中的 PyTorch 版本过旧，尚未提供 torch.float8_e4m3fn 属性。Forge 在 modules_forge/main_entry.py 中直接引用该属性，旧版 torch 没有该符号时便会抛出 AttributeError。Issue 评论指出 torch.float8_e4m3fn 仅在 PyTorch 2.1 及以后版本可用。

环境排查

确认 Forge 启动时实际加载的是哪一个 venv。Issue 中用户表示 Forge 目录下没有 venv，而是复用 A1111 的 venv。
在该 venv 中确认已安装的 torch 版本，判断是否低于 PyTorch 2.1。
确认 torchvision、torchaudio 与 torch 的版本是否匹配。
确认显卡与驱动环境：Issue 中为 RTX 2060 6GB VRAM。
Intel Arc 用户需额外确认使用的 IPEX / torch 自定义构建是否与 Forge 版本要求匹配。

解决步骤

关闭正在运行的 WebUI，确保没有进程占用 venv。
定位 Forge 实际使用的 venv 目录：本 Issue 中为 A1111 的 venv 文件夹，而非 Forge 目录下独立 venv。
激活该 venv（Windows 下通常执行 venv 目录中的 Scripts\activate）。
执行 pip install --upgrade torch torchvision torchaudio，将 torch 升级到包含 float8_e4m3fn 的版本（据讨论需 PyTorch 2.1 及以上）。此项为可优先尝试方案。
重新启动 Forge，观察启动日志是否仍停留在 modules_forge/main_entry.py 的 FP8 引用处。

验证方法

重新启动 Forge，若启动日志不再出现 AttributeError: module 'torch' has no attribute 'float8_e4m3fn'，并能继续加载后续模块直至成功进入 WebUI，即可认为问题已解决。也可在对应 venv 中查看 torch 版本，确认已升级到支持 FP8 的版本。