LoRA 下好了文件名看着挺正常往models/Lora里一丢回到 WebUI 点开 Lora 标签页——空的。再点一下刷新还是空的。干脆把 WebUI 关了重开依旧空的。这时候大多数人会开始怀疑人生是不是整合包有毛病是不是显卡不行是不是这个 LoRA 得花钱才能用。其实这类放进去了但页面加载不出来的问题九成以上跟显卡、跟整合包好坏都没关系它是一道路径题加一道缓存题。下面我把整套排查链路摊开讲从WebUI 到底在哪个文件夹里找 LoRA开始一路到为什么控制台一声不吭但界面就是不给面子中间会给出几套可以直接抄的检查方法和一张报错对照表。不管你是刚接触 SD 整合包的新手还是已经装过好几个版本的老用户照着走一遍基本都能定位到原因。1. LoRA 到底该放哪个文件夹先确认你的整合包是哪一套很多人一上来就问我放models/Lora了为什么不行但在回答这个问题之前得先确认一件事你装的到底是哪一套前端。因为 A1111、Forge、ComfyUI 这三套东西的目录结构长得像亲戚实际上差得挺远尤其是大小写和单复数这种细节在 Windows 上无所谓一旦你的整合包跑在 Linux、WSL 或者容器里就是致命的。1.1 三套主流前端的 LoRA 目录对照先看这张表对着自己的整合包根目录核一遍。这一步花不了一分钟但能排掉相当一部分低级错位。前端类型默认 LoRA 目录容易踩的细节A1111 WebUI多数整合包基于它models/Lora首字母大写 LWindows 不敏感Linux 敏感Forgemodels/Lora沿用 A1111 结构可直接搬ComfyUImodels/loras全小写且是复数与 A1111 完全不同SD.Nextmodels/Lora部分版本会额外扫描models/lycoris如果你装的是 ComfyUI 系整合包却把文件丢进了models/Lora那 WebUI 页面永远不可能显示——因为那个目录它根本就不读。反过来也一样。判断方法很简单打开整合包根目录看有没有webui-user.bat或.sh。有基本就是 A1111 或 Forge 系如果根目录里是一个ComfyUI文件夹加一堆run_nvidia_gpu.bat那是 ComfyUI路径要换成models/loras。我见过最典型的一次是对方把 LoRA 放进了extensions/sd-webui-additional-networks/models/lora。那个目录确实存在也确实跟 LoRA 有关但它属于扩展自己的缓存目录主程序扫描 LoRA 时不会去那里找。目录名里带 lora 的文件夹太多了认准主程序根目录下的models才是正路。1.2 用启动日志反查真实的扫描路径与其猜不如直接看程序自己怎么说的。启动 WebUI 的时候控制台会滚一大堆信息其中就包含它实际使用的模型路径。你需要关注的是启动参数回显那几行通常会看到类似lora_dir或者模型路径列表的输出。具体操作先完全关掉 WebUI不是最小化是关掉那个黑框然后重新运行启动脚本把控制台前二十行复制出来看。如果你在命令行参数里看到--lora-dir后面跟了一个路径那就以那个路径为准你之前放的models/Lora可能压根不是它在用的目录。还有一种更隐蔽的情况整合包作者为了让模型不占 C 盘空间把models目录做成了软链接junction指向 D 盘或者移动硬盘。这时候根目录下的models只是个指针你在资源管理器里双击进去看到的确实是 D 盘的内容但如果这个链接在某次系统更新或盘符变动后失效了你往里丢文件其实是丢进了一个已经断掉的空壳里。验证方法在整合包根目录的models/Lora里新建一个随便什么文件然后去你以为的D 盘真实目录里看看能不能找到它。找不到说明链接断了重新建一个或者干脆把--lora-dir指到真实目录。1.3 用 --lora-dir 把路径钉死如果你受够了到底放哪的反复横跳最干脆的做法是主动指定目录让它没得选。编辑webui-user.bat找到set COMMANDLINE_ARGS这一行在后面追加--lora-dir D:\sd-models\Lora保存后重启。这样无论整合包内部怎么折腾LoRA 一律从这个目录读。好处是路径唯一、可控坏处是以后换整合包记得改回来。我个人建议路径别带空格和中文纯英文短路径最省心比如D:\sdm\Lora这种既不占系统盘又不容易出编码问题。顺带说一句修改启动参数属于改配置级别的操作改之前把原文件复制一份留底这个习惯在折腾整合包的过程中能救你好几次。2. 文件本身的问题十个放对了却不显示里有六个栽在这路径确认无误之后下一个嫌疑对象就是文件本身。这里面的坑比路径更深因为从资源管理器看文件长得完全正常——有名字、有大小、有图标你根本看不出它有问题。2.1 扩展名伪装与压缩包陷阱从模型分享站下载文件时有相当一部分资源打包成压缩包发布尤其是那种一个 LoRA 配了多张预览图和说明文档的。你下载下来的是一个.zip或者.7z解压之后里面才是.safetensors。但如果你没解压直接把压缩包改名成.safetensors丢进去程序读取时就会报文件结构错误界面自然也不会显示。另一个常见情况是浏览器把文件下载成了网页。有些分享页需要登录或者有下载保护直接点下载按钮拿到的是一个 HTML 文件几百 KB 甚至几十 KB。文件名可能被自动拼成xxx.safetensors但内容其实是网页源码。识别方法正常的 LoRA 文件通常在几十 MB 到两百多 MB 之间SDXL 的会更大一些。如果你看到某个LoRA只有 200KB基本可以直接判定是假货。2.2 下载不完整留下的残骸文件下载中断、磁盘写满、浏览器崩溃都会留下半截文件。Windows 上常见的是.crdownload后缀下载工具留下的是.part、.downloading。这些文件肉眼一眼能看出来但如果下载完成度是 99%文件后缀已经正常了只是内容不全那就很难发现了。判断办法有两个一是看文件大小是否和分享页面标注的一致差得离谱就有问题二是用哈希值校验。很多模型站会给文件的 SHA256本地算一遍对比一下最踏实。算哈希不用装软件PowerShell 一行命令就行Get-FileHash D:\sdm\Lora\xxx.safetensors -Algorithm SHA256把输出和网页上的一串字符对比一模一样才算下载完整。这一步听着麻烦但只要遇到过一次下了一半的情况以后你就会养成习惯。2.3 文件名与路径里的隐患文件名里的中文、emoji、括号、井号、单引号都可能在某些环境下导致读取异常。尤其是在跨平台或者日志输出的时候编码处理稍微不严谨就会直接抛异常。建议把下载下来的文件名统一改成纯英文加数字加下划线比如char_style_v2.safetensors。这个动作花不了十秒钟但能省掉后面半小时的排查。比文件名更隐蔽的是路径总长度。Windows 传统上有个 260 字符的路径上限虽然现在可以通过设置放开但不少程序内部的读取逻辑仍然会在这个长度上出问题。如果你的整合包放在很深的目录里比如D:\下载\AI绘图\整合包\sd-webui-aki-v4.10\sd-webui-aki-v4\models\Lora\一些很长很长的中文文件夹名\这个文件的名字特别长_v3_final.safetensors累积起来轻松超过上限。解决办法就是把整合包挪到盘符根目录附近比如D:\sd\路径一下子短一大截。2.4 你下的可能根本不是 LoRA这一点容易被忽略。模型文件从功能上分成好几种大模型Checkpoint、LoRA、LyCORIS / LoCon、嵌入Embedding / Textual Inversion、VAE、ControlNet 模型。它们的文件扩展名经常都是.safetensors从文件名上不一定能区分。如果你把一个 LyCORIS 或者 LoCon 丢进models/Lora较新的版本可能能扫到老版本就可能识别失败或者干脆跳过。区分方法看文件大小Embedding 通常只有几十 KB 到几 MBVAE 一般在一两百 MBLoRA 多数在 10MB 到 300MB 之间Checkpoint 动辄 2GB 以上。如果你下的是几 GB 的大家伙那显然该放到models/Stable-diffusion而不是models/Lora。而几十 KB 的那个放到embeddings目录才对。3. 刷新机制与界面过滤UI 不显示的三种假故障路径对了文件也没问题但界面还是空。这时候大概率不是没加载而是加载了但你没看到。这一类问题特别气人因为程序其实完全正常。3.1 刷新按钮到底管什么WebUI 界面上有个小刷新图标通常在模型面板的右上角。这个按钮的作用是让前端重新向后端请求一次当前可用的模型列表。它的意义在于WebUI 启动时只扫描一次目录之后你在外面新增文件它不会自动感知必须手动触发扫描。所以标准动作是放完文件回到浏览器点那个刷新图标。注意是模型面板上的刷新不是浏览器的刷新这两者的作用范围完全不同。浏览器刷新只是重新拉取页面后端的模型列表如果没重新扫描前端拿到的还是旧列表。还有一个细节是按需加载模式。有些整合包默认开启了惰性加载模型列表是分批或者延迟返回的刚点刷新可能看不到等几秒或者滚动一下列表才会出现。遇到这种情况别急着判定失败先等等看。3.2 什么时候必须重启而不是刷新刷新按钮解决不了的情况主要有两种。第一种是文件在扫描时被判定为损坏。程序扫描一遍发现读不了会把它标记为无效并跳过。之后再点刷新它可能仍然沿用之前的判断结果不一定重新读取。这时候必须重启程序让它重新走一遍完整的扫描流程。第二种是你在启动参数里新增了--lora-dir或者修改了目录结构。参数只在启动时解析一次改完不重启等于没改。我的习惯是新增文件用刷新改了配置或动了目录一律重启。这个规则简单能覆盖绝大多数情况。3.3 搜索框和标签页过滤造成的看起来是空的这是最常见也最容易被忽略的一点。模型面板上通常有个搜索/过滤输入框还有一排分类标签Checkpoint、LoRA、Embedding、Hypernetwork 等。如果你之前在里面搜过关键词或者当前选中的标签页不是 LoRA那么打开面板看到的列表自然就是空的或者不含 LoRA。排查动作把搜索框清空确认标签页切到 LoRA 这一栏再滚一下列表。就这么两步我在社区里见过的求助帖里起码有相当一部分最后是这么解决的当事人还挺不好意思。另外还有一种情况是面板折叠了。Extra Networks 面板在某些主题下默认是收起状态需要点一下标题栏展开。界面语言、主题、浏览器缩放比例都可能让这个面板看起来不存在。4. 从控制台日志定位真凶报错信息对照表前面三节都是猜这一节讲看。控制台日志是唯一不会骗你的信息来源学会读它排查效率能提升好几个量级。4.1 启动阶段的扫描输出启动时留意有没有出现文件名相关的报错行。如果某个 LoRA 文件有问题程序通常在扫描阶段就会哔一句。你可以用关键词搜索日志把控制台内容复制到文本编辑器里搜lora和error这两个词。搜到具体文件名说明问题就锁定在那个文件上跟路径、跟配置都没关系。如果搜完发现日志里压根没提到你新放的文件名那说明它根本没被扫描到——问题回到路径上回到第 1 节重新确认目录。4.2 常见报错与处理方向对照日志关键字大致含义处理方向Error loading lora读取该文件时失败重新下载优先怀疑文件不完整SafetensorError文件结构损坏或不是标准格式校验哈希确认不是压缩包改名KeyError加一串键名文件内部键名与预期不符可能不是标准 LoRA检查模型类型No such file or directory路径不存在检查目录是否写错、软链接是否失效Permission denied权限不足检查文件属性、杀毒软件隔离区OutOfMemory显存不足换更小的分辨率或更小的模型与不显示无关最后一行要特别说明一下显存不足不会导致 LoRA 不出现在列表里它只会在你实际使用的时候报错。很多人把这两件事混在一起白白折腾了半天驱动。4.3 日志干净但界面死活不显示这种情况我遇到过两次两次原因都不一样。第一次是浏览器缓存。前端拿的是缓存里的旧列表后端其实早就更新了。解决方法是硬刷新按Ctrl F5或者打开开发者工具勾选禁用缓存后再刷新。这个动作和点模型面板的刷新按钮是两个层面的操作一个刷前端一个刷后端都要做。第二次是浏览器装了个拦截类的扩展把模型列表的接口请求给拦了。表现就是控制台里干干净净页面上就是没有。排查方法很简单开一个无痕窗口访问同一个地址如果无痕窗口能看到那就是扩展的问题把扩展关掉或者把 WebUI 地址加白名单就行。5. 环境层面的几个隐形杀手走到这一步还没解决那就该往环境层面看了。这些问题平时不出现一旦出现就非常难查因为它们往往没有任何直接报错。5.1 权限、杀毒软件与文件被吃掉安全软件对.safetensors这类文件的态度有时候很微妙。它不会弹窗提示而是直接把文件挪进隔离区或者阻止读取。表现就是你明明放进去过过一会儿回去看文件不见了或者文件在但程序读不到。排查动作先确认文件物理上还在不在原位置。如果不见了去安全软件的隔离记录里翻一翻。如果还在但读不到把整合包所在目录加进白名单。另外一个容易忽略的是文件属性从别的电脑拷过来的文件有时会带上锁定属性右键属性里如果能看到解除锁定的勾选框勾掉它。还有一种更微妙的情况是权限继承问题。如果你的整合包放在系统盘的用户目录下而你是用管理员身份运行某个操作创建的文件普通权限的进程可能读不到。解决办法是把整合包整个挪到一个权限简单的位置比如D:\sd\右键属性把只读去掉确保当前用户可以完全控制。5.2 中文用户名、OneDrive 与编码问题Windows 用户名是中文的时候用户目录路径里就带中文。很多程序在拼接路径的时候没做编码处理遇到中文路径就会出各种奇怪的问题。如果你恰好把整合包放在了C:\Users\张三\Desktop\...这种路径下那问题很可能就出在这。解决方法是把整个整合包挪到D:\下面路径里一个中文字符都不要有。OneDrive 同步目录也是个大坑。放在 OneDrive 文件夹里的文件会被同步进程占用程序读取时可能拿到一个正在同步中的占位文件。表现就是文件名对、大小也对但内容读不出来。判断方法看任务栏的 OneDrive 图标有没有在转有的话等它同步完或者干脆别把模型放 OneDrive 里。5.3 版本过旧与依赖缺失最后还有一种情况是老版本对新格式支持不好。如果你的整合包是两年前下的那时候对 LoRA 的支持方式和现在不一样某些用新工具训练出来的 LoRA 可能就加载不了。判断方法看启动时的版本号或者直接更新整合包。不过更新这事要谨慎整合包更新往往牵扯到依赖库的版本变化可能把原本能用的插件搞崩。稳妥做法是先把models目录备份出来更新之后再把模型放回去。至于依赖缺失一般会在控制台里明确报出某个库的导入错误看到那种报错去整合包自带的更新脚本里跑一遍依赖安装基本能解决。6. 一套可以照着走的排查顺序讲了这么多原因最后把它们串成一条可以照着执行的线。顺序很重要从最省事的开始逐步深入避免一上来就干重活。6.1 五分钟快速定位流程清空模型面板的搜索框确认标签页切到 LoRA展开折叠的面板再刷新一次。点模型面板右上角的刷新按钮等三秒硬刷新浏览器Ctrl F5。还不行就把 WebUI 完整重启一次。重启后仍然不显示去控制台搜文件名看有没有被扫描到。没被扫描到回头确认目录结构对照第 1 节的表格。被扫描到但有报错处理文件本身重新下载、校验哈希、改纯英文名。这套流程走下来通常在前三步就能解决大部分问题。真正需要走到第六步的情况其实不多。6.2 排查清单检查项具体动作常见结论目录位置确认models/Lora存在于整合包根目录下放错到 ComfyUI 或扩展目录扫描路径查看启动参数有没有--lora-dir存在则以该路径为准文件完整性对比文件大小与哈希值下载中断或是不完整文件文件格式确认扩展名且不是压缩包改名实际是 zip 或网页文件文件命名改为纯英文路径尽量短中文或超长路径导致读取失败界面状态清空搜索框、切换标签、展开面板过滤条件挡住的假空刷新方式面板刷新 浏览器硬刷新前后端缓存不同步环境因素检查杀毒隔离、权限、同步目录文件被拦截或占用版本支持核对整合包版本老版本不支持新格式6.3 我踩坑之后养成的几个习惯折腾了这么多次我现在固定用一套目录规范基本没再出过问题。整合包统一放在D:\sd\下LoRA 统一放在D:\sd\models\Lora\所有模型文件名一律英文小写下划线分隔下载完先算一次哈希再往里放。这四条听着啰嗦但能覆盖掉绝大多数加载不出来的场景。另外我强烈建议做一件事每次新增模型后先看控制台再关窗口。很多人操作完顺手就把黑框关了等到发现问题时日志已经没了只能靠猜。日志在的时候看一眼十秒钟的事日志没了就得从头再来一遍。这个习惯帮我省下的时间比任何技巧都多。还有个小技巧是给不同来源的模型分文件夹。A1111 支持子目录所以可以建models/Lora/character、models/Lora/style、models/Lora/concept这样的分类。好处是多了之后好找而且万一某个子目录里的文件批量出问题一眼就能定位到是那批下载的问题。唯一要注意的是文件夹名同样建议用纯英文别用中文分类名避免踩到编码的坑。最后再提一句容易被忽略的如果你同时装了多个整合包建议每个整合包的 LoRA 目录用软链接指到同一个真实目录而不是把文件复制好几份。这样只要维护一份模型库新增一次全部生效也不会出现这个包里能看到那个包里看不到的错觉。软链接创建命令在 Windows 上要用管理员权限的命令行mklink /J D:\sd-a\models\Lora D:\sdm\Lora建完之后进去看一眼能看到文件就说明链接是活的。这个做法我从整理模型库开始一直用到现在模型数量上到三位数之后你会感谢当初做了这个决定。
Stable Diffusion LoRA加载失败：WebUI路径与刷新排查
LoRA 下好了文件名看着挺正常往models/Lora里一丢回到 WebUI 点开 Lora 标签页——空的。再点一下刷新还是空的。干脆把 WebUI 关了重开依旧空的。这时候大多数人会开始怀疑人生是不是整合包有毛病是不是显卡不行是不是这个 LoRA 得花钱才能用。其实这类放进去了但页面加载不出来的问题九成以上跟显卡、跟整合包好坏都没关系它是一道路径题加一道缓存题。下面我把整套排查链路摊开讲从WebUI 到底在哪个文件夹里找 LoRA开始一路到为什么控制台一声不吭但界面就是不给面子中间会给出几套可以直接抄的检查方法和一张报错对照表。不管你是刚接触 SD 整合包的新手还是已经装过好几个版本的老用户照着走一遍基本都能定位到原因。1. LoRA 到底该放哪个文件夹先确认你的整合包是哪一套很多人一上来就问我放models/Lora了为什么不行但在回答这个问题之前得先确认一件事你装的到底是哪一套前端。因为 A1111、Forge、ComfyUI 这三套东西的目录结构长得像亲戚实际上差得挺远尤其是大小写和单复数这种细节在 Windows 上无所谓一旦你的整合包跑在 Linux、WSL 或者容器里就是致命的。1.1 三套主流前端的 LoRA 目录对照先看这张表对着自己的整合包根目录核一遍。这一步花不了一分钟但能排掉相当一部分低级错位。前端类型默认 LoRA 目录容易踩的细节A1111 WebUI多数整合包基于它models/Lora首字母大写 LWindows 不敏感Linux 敏感Forgemodels/Lora沿用 A1111 结构可直接搬ComfyUImodels/loras全小写且是复数与 A1111 完全不同SD.Nextmodels/Lora部分版本会额外扫描models/lycoris如果你装的是 ComfyUI 系整合包却把文件丢进了models/Lora那 WebUI 页面永远不可能显示——因为那个目录它根本就不读。反过来也一样。判断方法很简单打开整合包根目录看有没有webui-user.bat或.sh。有基本就是 A1111 或 Forge 系如果根目录里是一个ComfyUI文件夹加一堆run_nvidia_gpu.bat那是 ComfyUI路径要换成models/loras。我见过最典型的一次是对方把 LoRA 放进了extensions/sd-webui-additional-networks/models/lora。那个目录确实存在也确实跟 LoRA 有关但它属于扩展自己的缓存目录主程序扫描 LoRA 时不会去那里找。目录名里带 lora 的文件夹太多了认准主程序根目录下的models才是正路。1.2 用启动日志反查真实的扫描路径与其猜不如直接看程序自己怎么说的。启动 WebUI 的时候控制台会滚一大堆信息其中就包含它实际使用的模型路径。你需要关注的是启动参数回显那几行通常会看到类似lora_dir或者模型路径列表的输出。具体操作先完全关掉 WebUI不是最小化是关掉那个黑框然后重新运行启动脚本把控制台前二十行复制出来看。如果你在命令行参数里看到--lora-dir后面跟了一个路径那就以那个路径为准你之前放的models/Lora可能压根不是它在用的目录。还有一种更隐蔽的情况整合包作者为了让模型不占 C 盘空间把models目录做成了软链接junction指向 D 盘或者移动硬盘。这时候根目录下的models只是个指针你在资源管理器里双击进去看到的确实是 D 盘的内容但如果这个链接在某次系统更新或盘符变动后失效了你往里丢文件其实是丢进了一个已经断掉的空壳里。验证方法在整合包根目录的models/Lora里新建一个随便什么文件然后去你以为的D 盘真实目录里看看能不能找到它。找不到说明链接断了重新建一个或者干脆把--lora-dir指到真实目录。1.3 用 --lora-dir 把路径钉死如果你受够了到底放哪的反复横跳最干脆的做法是主动指定目录让它没得选。编辑webui-user.bat找到set COMMANDLINE_ARGS这一行在后面追加--lora-dir D:\sd-models\Lora保存后重启。这样无论整合包内部怎么折腾LoRA 一律从这个目录读。好处是路径唯一、可控坏处是以后换整合包记得改回来。我个人建议路径别带空格和中文纯英文短路径最省心比如D:\sdm\Lora这种既不占系统盘又不容易出编码问题。顺带说一句修改启动参数属于改配置级别的操作改之前把原文件复制一份留底这个习惯在折腾整合包的过程中能救你好几次。2. 文件本身的问题十个放对了却不显示里有六个栽在这路径确认无误之后下一个嫌疑对象就是文件本身。这里面的坑比路径更深因为从资源管理器看文件长得完全正常——有名字、有大小、有图标你根本看不出它有问题。2.1 扩展名伪装与压缩包陷阱从模型分享站下载文件时有相当一部分资源打包成压缩包发布尤其是那种一个 LoRA 配了多张预览图和说明文档的。你下载下来的是一个.zip或者.7z解压之后里面才是.safetensors。但如果你没解压直接把压缩包改名成.safetensors丢进去程序读取时就会报文件结构错误界面自然也不会显示。另一个常见情况是浏览器把文件下载成了网页。有些分享页需要登录或者有下载保护直接点下载按钮拿到的是一个 HTML 文件几百 KB 甚至几十 KB。文件名可能被自动拼成xxx.safetensors但内容其实是网页源码。识别方法正常的 LoRA 文件通常在几十 MB 到两百多 MB 之间SDXL 的会更大一些。如果你看到某个LoRA只有 200KB基本可以直接判定是假货。2.2 下载不完整留下的残骸文件下载中断、磁盘写满、浏览器崩溃都会留下半截文件。Windows 上常见的是.crdownload后缀下载工具留下的是.part、.downloading。这些文件肉眼一眼能看出来但如果下载完成度是 99%文件后缀已经正常了只是内容不全那就很难发现了。判断办法有两个一是看文件大小是否和分享页面标注的一致差得离谱就有问题二是用哈希值校验。很多模型站会给文件的 SHA256本地算一遍对比一下最踏实。算哈希不用装软件PowerShell 一行命令就行Get-FileHash D:\sdm\Lora\xxx.safetensors -Algorithm SHA256把输出和网页上的一串字符对比一模一样才算下载完整。这一步听着麻烦但只要遇到过一次下了一半的情况以后你就会养成习惯。2.3 文件名与路径里的隐患文件名里的中文、emoji、括号、井号、单引号都可能在某些环境下导致读取异常。尤其是在跨平台或者日志输出的时候编码处理稍微不严谨就会直接抛异常。建议把下载下来的文件名统一改成纯英文加数字加下划线比如char_style_v2.safetensors。这个动作花不了十秒钟但能省掉后面半小时的排查。比文件名更隐蔽的是路径总长度。Windows 传统上有个 260 字符的路径上限虽然现在可以通过设置放开但不少程序内部的读取逻辑仍然会在这个长度上出问题。如果你的整合包放在很深的目录里比如D:\下载\AI绘图\整合包\sd-webui-aki-v4.10\sd-webui-aki-v4\models\Lora\一些很长很长的中文文件夹名\这个文件的名字特别长_v3_final.safetensors累积起来轻松超过上限。解决办法就是把整合包挪到盘符根目录附近比如D:\sd\路径一下子短一大截。2.4 你下的可能根本不是 LoRA这一点容易被忽略。模型文件从功能上分成好几种大模型Checkpoint、LoRA、LyCORIS / LoCon、嵌入Embedding / Textual Inversion、VAE、ControlNet 模型。它们的文件扩展名经常都是.safetensors从文件名上不一定能区分。如果你把一个 LyCORIS 或者 LoCon 丢进models/Lora较新的版本可能能扫到老版本就可能识别失败或者干脆跳过。区分方法看文件大小Embedding 通常只有几十 KB 到几 MBVAE 一般在一两百 MBLoRA 多数在 10MB 到 300MB 之间Checkpoint 动辄 2GB 以上。如果你下的是几 GB 的大家伙那显然该放到models/Stable-diffusion而不是models/Lora。而几十 KB 的那个放到embeddings目录才对。3. 刷新机制与界面过滤UI 不显示的三种假故障路径对了文件也没问题但界面还是空。这时候大概率不是没加载而是加载了但你没看到。这一类问题特别气人因为程序其实完全正常。3.1 刷新按钮到底管什么WebUI 界面上有个小刷新图标通常在模型面板的右上角。这个按钮的作用是让前端重新向后端请求一次当前可用的模型列表。它的意义在于WebUI 启动时只扫描一次目录之后你在外面新增文件它不会自动感知必须手动触发扫描。所以标准动作是放完文件回到浏览器点那个刷新图标。注意是模型面板上的刷新不是浏览器的刷新这两者的作用范围完全不同。浏览器刷新只是重新拉取页面后端的模型列表如果没重新扫描前端拿到的还是旧列表。还有一个细节是按需加载模式。有些整合包默认开启了惰性加载模型列表是分批或者延迟返回的刚点刷新可能看不到等几秒或者滚动一下列表才会出现。遇到这种情况别急着判定失败先等等看。3.2 什么时候必须重启而不是刷新刷新按钮解决不了的情况主要有两种。第一种是文件在扫描时被判定为损坏。程序扫描一遍发现读不了会把它标记为无效并跳过。之后再点刷新它可能仍然沿用之前的判断结果不一定重新读取。这时候必须重启程序让它重新走一遍完整的扫描流程。第二种是你在启动参数里新增了--lora-dir或者修改了目录结构。参数只在启动时解析一次改完不重启等于没改。我的习惯是新增文件用刷新改了配置或动了目录一律重启。这个规则简单能覆盖绝大多数情况。3.3 搜索框和标签页过滤造成的看起来是空的这是最常见也最容易被忽略的一点。模型面板上通常有个搜索/过滤输入框还有一排分类标签Checkpoint、LoRA、Embedding、Hypernetwork 等。如果你之前在里面搜过关键词或者当前选中的标签页不是 LoRA那么打开面板看到的列表自然就是空的或者不含 LoRA。排查动作把搜索框清空确认标签页切到 LoRA 这一栏再滚一下列表。就这么两步我在社区里见过的求助帖里起码有相当一部分最后是这么解决的当事人还挺不好意思。另外还有一种情况是面板折叠了。Extra Networks 面板在某些主题下默认是收起状态需要点一下标题栏展开。界面语言、主题、浏览器缩放比例都可能让这个面板看起来不存在。4. 从控制台日志定位真凶报错信息对照表前面三节都是猜这一节讲看。控制台日志是唯一不会骗你的信息来源学会读它排查效率能提升好几个量级。4.1 启动阶段的扫描输出启动时留意有没有出现文件名相关的报错行。如果某个 LoRA 文件有问题程序通常在扫描阶段就会哔一句。你可以用关键词搜索日志把控制台内容复制到文本编辑器里搜lora和error这两个词。搜到具体文件名说明问题就锁定在那个文件上跟路径、跟配置都没关系。如果搜完发现日志里压根没提到你新放的文件名那说明它根本没被扫描到——问题回到路径上回到第 1 节重新确认目录。4.2 常见报错与处理方向对照日志关键字大致含义处理方向Error loading lora读取该文件时失败重新下载优先怀疑文件不完整SafetensorError文件结构损坏或不是标准格式校验哈希确认不是压缩包改名KeyError加一串键名文件内部键名与预期不符可能不是标准 LoRA检查模型类型No such file or directory路径不存在检查目录是否写错、软链接是否失效Permission denied权限不足检查文件属性、杀毒软件隔离区OutOfMemory显存不足换更小的分辨率或更小的模型与不显示无关最后一行要特别说明一下显存不足不会导致 LoRA 不出现在列表里它只会在你实际使用的时候报错。很多人把这两件事混在一起白白折腾了半天驱动。4.3 日志干净但界面死活不显示这种情况我遇到过两次两次原因都不一样。第一次是浏览器缓存。前端拿的是缓存里的旧列表后端其实早就更新了。解决方法是硬刷新按Ctrl F5或者打开开发者工具勾选禁用缓存后再刷新。这个动作和点模型面板的刷新按钮是两个层面的操作一个刷前端一个刷后端都要做。第二次是浏览器装了个拦截类的扩展把模型列表的接口请求给拦了。表现就是控制台里干干净净页面上就是没有。排查方法很简单开一个无痕窗口访问同一个地址如果无痕窗口能看到那就是扩展的问题把扩展关掉或者把 WebUI 地址加白名单就行。5. 环境层面的几个隐形杀手走到这一步还没解决那就该往环境层面看了。这些问题平时不出现一旦出现就非常难查因为它们往往没有任何直接报错。5.1 权限、杀毒软件与文件被吃掉安全软件对.safetensors这类文件的态度有时候很微妙。它不会弹窗提示而是直接把文件挪进隔离区或者阻止读取。表现就是你明明放进去过过一会儿回去看文件不见了或者文件在但程序读不到。排查动作先确认文件物理上还在不在原位置。如果不见了去安全软件的隔离记录里翻一翻。如果还在但读不到把整合包所在目录加进白名单。另外一个容易忽略的是文件属性从别的电脑拷过来的文件有时会带上锁定属性右键属性里如果能看到解除锁定的勾选框勾掉它。还有一种更微妙的情况是权限继承问题。如果你的整合包放在系统盘的用户目录下而你是用管理员身份运行某个操作创建的文件普通权限的进程可能读不到。解决办法是把整合包整个挪到一个权限简单的位置比如D:\sd\右键属性把只读去掉确保当前用户可以完全控制。5.2 中文用户名、OneDrive 与编码问题Windows 用户名是中文的时候用户目录路径里就带中文。很多程序在拼接路径的时候没做编码处理遇到中文路径就会出各种奇怪的问题。如果你恰好把整合包放在了C:\Users\张三\Desktop\...这种路径下那问题很可能就出在这。解决方法是把整个整合包挪到D:\下面路径里一个中文字符都不要有。OneDrive 同步目录也是个大坑。放在 OneDrive 文件夹里的文件会被同步进程占用程序读取时可能拿到一个正在同步中的占位文件。表现就是文件名对、大小也对但内容读不出来。判断方法看任务栏的 OneDrive 图标有没有在转有的话等它同步完或者干脆别把模型放 OneDrive 里。5.3 版本过旧与依赖缺失最后还有一种情况是老版本对新格式支持不好。如果你的整合包是两年前下的那时候对 LoRA 的支持方式和现在不一样某些用新工具训练出来的 LoRA 可能就加载不了。判断方法看启动时的版本号或者直接更新整合包。不过更新这事要谨慎整合包更新往往牵扯到依赖库的版本变化可能把原本能用的插件搞崩。稳妥做法是先把models目录备份出来更新之后再把模型放回去。至于依赖缺失一般会在控制台里明确报出某个库的导入错误看到那种报错去整合包自带的更新脚本里跑一遍依赖安装基本能解决。6. 一套可以照着走的排查顺序讲了这么多原因最后把它们串成一条可以照着执行的线。顺序很重要从最省事的开始逐步深入避免一上来就干重活。6.1 五分钟快速定位流程清空模型面板的搜索框确认标签页切到 LoRA展开折叠的面板再刷新一次。点模型面板右上角的刷新按钮等三秒硬刷新浏览器Ctrl F5。还不行就把 WebUI 完整重启一次。重启后仍然不显示去控制台搜文件名看有没有被扫描到。没被扫描到回头确认目录结构对照第 1 节的表格。被扫描到但有报错处理文件本身重新下载、校验哈希、改纯英文名。这套流程走下来通常在前三步就能解决大部分问题。真正需要走到第六步的情况其实不多。6.2 排查清单检查项具体动作常见结论目录位置确认models/Lora存在于整合包根目录下放错到 ComfyUI 或扩展目录扫描路径查看启动参数有没有--lora-dir存在则以该路径为准文件完整性对比文件大小与哈希值下载中断或是不完整文件文件格式确认扩展名且不是压缩包改名实际是 zip 或网页文件文件命名改为纯英文路径尽量短中文或超长路径导致读取失败界面状态清空搜索框、切换标签、展开面板过滤条件挡住的假空刷新方式面板刷新 浏览器硬刷新前后端缓存不同步环境因素检查杀毒隔离、权限、同步目录文件被拦截或占用版本支持核对整合包版本老版本不支持新格式6.3 我踩坑之后养成的几个习惯折腾了这么多次我现在固定用一套目录规范基本没再出过问题。整合包统一放在D:\sd\下LoRA 统一放在D:\sd\models\Lora\所有模型文件名一律英文小写下划线分隔下载完先算一次哈希再往里放。这四条听着啰嗦但能覆盖掉绝大多数加载不出来的场景。另外我强烈建议做一件事每次新增模型后先看控制台再关窗口。很多人操作完顺手就把黑框关了等到发现问题时日志已经没了只能靠猜。日志在的时候看一眼十秒钟的事日志没了就得从头再来一遍。这个习惯帮我省下的时间比任何技巧都多。还有个小技巧是给不同来源的模型分文件夹。A1111 支持子目录所以可以建models/Lora/character、models/Lora/style、models/Lora/concept这样的分类。好处是多了之后好找而且万一某个子目录里的文件批量出问题一眼就能定位到是那批下载的问题。唯一要注意的是文件夹名同样建议用纯英文别用中文分类名避免踩到编码的坑。最后再提一句容易被忽略的如果你同时装了多个整合包建议每个整合包的 LoRA 目录用软链接指到同一个真实目录而不是把文件复制好几份。这样只要维护一份模型库新增一次全部生效也不会出现这个包里能看到那个包里看不到的错觉。软链接创建命令在 Windows 上要用管理员权限的命令行mklink /J D:\sd-a\models\Lora D:\sdm\Lora建完之后进去看一眼能看到文件就说明链接是活的。这个做法我从整理模型库开始一直用到现在模型数量上到三位数之后你会感谢当初做了这个决定。
)
