LoRA 加载报 lora key not loaded：LoRA 与底模架构不匹配或被当成 checkpoint 加载

lora key not loaded: blocks.0.cross_attn.k.alpha
lora key not loaded: blocks.0.cross_attn.k.lora_down.weight
lora key not loaded: blocks.0.cross_attn.k.lora_up.weight
lora key not loaded: blocks.0.cross_attn.o.alpha
lora key not loaded: blocks.0.cross_attn.q.alpha

现象与触发场景

常见触发场景：

• SD1.5/SDXL 的 LoRA 用在 Flux、Wan、Z-Image、Qwen-Image 等其它架构的底模上
• 把 LoRA 文件丢进 models/checkpoints 用 Load Checkpoint 加载，或反过来把 checkpoint 交给 LoRA 加载器
• LoRA 训练侧导出的键名带 model. / diffusion_model. / transformer. 等前缀，与 ComfyUI 期望的键名对不上
• LoKr/LoHa 等变体格式与当前 ComfyUI 版本的加载实现不匹配

根因

• LoRA 是靠键名匹配注入到底模对应层上的：键名找不到对应层，该部分权重就被静默丢弃，只打印 lora key not loaded，不报错、不中断，结果就是「加载成功但没效果」。
• 架构不匹配时键名整体对不上（例如 blocks.N.cross_attn.* 属于视频 DiT 结构），于是一整批键全部 not loaded。
• 反过来，把 LoRA 当 checkpoint 加载会因为缺少完整的 UNet/CLIP 权重而报缺键；把 checkpoint 交给 LoRA 加载器则找不到 lora_down/lora_up 结构。
• LoRA 只能作用于同架构、同基础版本的底模；训练侧键名规范（前缀、命名规则）也会直接决定能否被 ComfyUI 识别。

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

1. 第一步：先确认底模架构与 LoRA 训练底模一致
   LoRA 的适用架构由训练时的底模决定：SD1.5 的 LoRA 只能配 SD1.5，SDXL 的只能配 SDXL 系（含 Illustrious/Pony 等同系派生），Flux 的只能配 Flux。对不上就换模型，不要指望靠参数补救。同时确认加载器节点选对了：Load LoRA 用于常规 LoRA，LoRA Loader 类节点不要用来加载完整 checkpoint。
2. 第二步：核对文件放置目录与扩展名
   LoRA 必须放在 models/loras（含子目录也可以），不要放 models/checkpoints。放置后刷新（按 R）或重启，再到 LoraLoader 的 lora_name 下拉里选中它。如果下拉框里根本没有它，属于上一条 value not in list 的问题。
   ComfyUI/models/loras/
3. 第三步：键名前缀不匹配时做键名转换
   如果 LoRA 来自其它训练框架，键名可能带 transformer. / diffusion_model. / model. 之类前缀，需要用键名转换类节点（社区有 Convert LoRA Keys 之类的工具节点）或按训练框架的导出规范重新导出。判断依据就是控制台里那串 not loaded 的键名——把它和底模实际层名对照，前缀差在哪一目了然。
4. 第四步：确认 ComfyUI 与节点版本是否已支持该格式
   同一份 LoRA 在别人机器上有效、在你这里 not loaded，通常是你版本偏旧。更新 ComfyUI 本体并更新对应的自定义节点后重试；新架构（Z-Image、Flux 2、ACE-Step 等）的 LoRA/LoKr 支持是随版本陆续加入的，早期版本只有「权重被忽略」这一种表现。

验证是否修好

补充说明

lora key not loaded 是警告而非异常，容易被误判为「加载成功」。若键名全部 not loaded 但节点不报错，等同于 LoRA 完全没生效。

来源

1. [100] （社区）　250928 low noise：lora key not loaded issue - lora key not loaded: bloc　https://huggingface.co/lightx2v/Wan2.2-Lightning/discussions/42
2. [101] （官方 issue）　Z-Image Turbo LoKR: "lora key not loaded" and weights ignored (LoRA wo　https://github.com/Comfy-Org/ComfyUI/issues/10973
3. [102] （节点仓库 issue）　When using Z-Image LoRA with ComfyUI, the message "lora key not loaded　https://github.com/ostris/ai-toolkit/issues/538
4. [103] （社区）　LoRA loading errors with Wan2_2-Animate-14B_fp8_scaled_e4m3fn_KJ_v2.sa　https://huggingface.co/Kijai/WanVideo_comfy_fp8_scaled/discussions/24

本条报错提到的目录

本条报错的原文或解决步骤里出现了下面这些 models/ 子目录。 权重库里放在这些目录下的文件已按目录列好，可对照确认自己缺的是哪几个。

这条报错要用到的东西

按本条报错所属的类别（模型与权重文件加载）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库