Missing `config.json` file

问题场景

用户在更新 Fooocus 项目后启动 WebUI，程序在加载 prompt expansion 模块时崩溃。报错发生在 modules/expansion.py 初始化 FooocusExpansion()，随后由 Transformers 的 AutoTokenizer.from_pretrained() 读取本地 fooocus_expansion 目录时触发。用户的目录中只有 pytorch_model.bin，没有 config.json。评论中也有用户说明自己用 symlink 把 models 指向 ComfyUI 安装目录，一次 git pull 没有正确更新该模型目录，导致新加文件缺失。

报错原文

Exception in thread Thread-3 (worker):
Traceback (most recent call last):
  File "threading.py", line 1016, in _bootstrap_inner
  File "threading.py", line 953, in run
  File "\Path\to\Fooocus_win64_1-1-1035_4\Fooocus\modules\async_worker.py", line 14, in worker
    import modules.default_pipeline as pipeline
  File "\Path\to\Fooocus_win64_1-1-1035_4\Fooocus\modules\default_pipeline.py", line 106, in <module>
    expansion = FooocusExpansion()
  File "\Path\to\Fooocus_win64_1-1-1035_4\Fooocus\modules\expansion.py", line 29, in __init__
    self.tokenizer = AutoTokenizer.from_pretrained(fooocus_expansion_path)
  File "\Path\to\Fooocus_win64_1-1-1035_4\python_embeded\lib\site-packages\transformers\models\auto\tokenization_auto.py", line 658, in from_pretrained
    config = AutoConfig.from_pretrained(
  File "\Path\to\Fooocus_win64_1-1-1035_4\python_embeded\lib\site-packages\transformers\models\auto\configuration_auto.py", line 944, in from_pretrained
    config_dict, unused_kwargs = PretrainedConfig.get_config_dict(pretrained_model_name_or_path, **kwargs)
  File "\Path\to\Fooocus_win64_1-1-1035_4\python_embeded\lib\site-packages\transformers\configuration_utils.py", line 574, in get_config_dict
    config_dict, kwargs = cls._get_config_dict(pretrained_model_name_or_path, **kwargs)
  File "\Path\to\Fooocus_win64_1-1-1035_4\python_embeded\lib\site-packages\transformers\configuration_utils.py", line 629, in _get_config_dict
    resolved_config_file = cached_file(
  File "\Path\to\Fooocus_win64_1-1-1035_4\python_embeded\lib\site-packages\transformers\utils\hub.py", line 388, in cached_file
    raise EnvironmentError(
OSError: \Path\to\Fooocus_win64_1-1-1035_4\Fooocus\models\prompt_expansion\fooocus_expansion does not appear to have a file named config.json. Checkout 'https://huggingface.co/\Path\to\Fooocus_win64_1-1-1035_4\Fooocus\models\prompt_expansion\fooocus_expansion/None' for available files.

原因分析

最可能的原因是 models/prompt_expansion/fooocus_expansion/ 缺少 tokenizer 配置文件，尤其是 config.json。Fooocus 启动时会加载 prompt expansion 相关组件，并通过 Transformers 从本地目录读取 tokenizer；如果该目录只有 pytorch_model.bin，就会触发上述 OSError。

评论中提供了两类可能场景：一种是更新或 git pull 没有正确同步新增模型文件，尤其当 models 目录被 symlink 到其他安装目录时；另一种是使用 Pinokio 等封装安装，仓库结构和路径不同，直接使用通用 Git 恢复命令会失败。Issue 结束时没有给出适用于所有安装方式的一步修复方案。

环境排查

• 确认 Fooocus 是 Git 克隆、Windows 便携包、Pinokio 安装还是 Fooocus-API 相关安装。
• 检查 models/prompt_expansion/fooocus_expansion/ 是否只有 pytorch_model.bin，缺少 config.json 等文件。
• 如果 models 目录是 symlink，确认链接目标是否被正确更新，以及是否仍指向可写且内容完整的模型目录。
• 确认当前终端所在目录是否为 Fooocus 仓库根目录；Pinokio 等环境可能需要检查 app/models/prompt_expansion/ 这类实际路径。
• Issue 未确认 Python、CUDA、PyTorch、显卡和依赖版本，这些项目无需作为本问题的首要排查项。

解决步骤

1. 先备份当前 models/prompt_expansion/ 目录，避免本地已有文件被覆盖。
2. 进入 Fooocus 仓库根目录。
3. 尝试执行 Issue 评论中给出的恢复命令：git restore models/prompt_expansion/。该命令用于恢复 Git 仓库中该路径下的文件，使缺失的 config.json 等文件回到本地。
4. 如果命令报 error: pathspec 'app/models/prompt_expansion/' did not match any file(s) known to git，说明实际路径或仓库结构与命令不匹配；请根据你的安装方式检查真实路径，不要直接套用。
5. 如果你使用 symlink，请确认恢复的是链接目标目录中的内容，而不是只修改链接本身。
6. 如果恢复后目录中仍没有 config.json，可查看仓库中 prompt_expansion/fooocus_expansion 路径下应包含哪些文件，并补齐缺失项；具体文件列表以你的 Fooocus 版本为准。

验证方法

确认 models/prompt_expansion/fooocus_expansion/ 中已存在 config.json，并重新启动 Fooocus WebUI。如果启动过程中不再出现 OSError: ... does not appear to have a file named config.json，且 prompt expansion 初始化不再中断，即说明该问题已解决。

参考来源

lllyasviel/Fooocus #341

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。