AnimateDiff：找不到运动模块 mm_sd_v15_v2.ckpt（motion module 缺失）

Error occurred when executing ADE_AnimateDiffLoaderWithContext

现象与触发场景

常见触发场景：

• 没下载运动模块 ckpt，或没有放进 AnimateDiff 节点要求的目录
• 运动模块与底模版本不匹配（SD1.5 的运动模块配 SDXL 底模）
• AnimateDiff / AnimateDiff-Evolved 节点装了两份或版本混装，节点互相冲突

根因

• AnimateDiff 的运动模块（motion module，如 mm_sd_v15_v2.ckpt）是与节点分离的模型文件，必须单独下载并放入 ComfyUI/models/animatediff_models（部分节点版本读取 models/animatediff），未下载或目录错误时加载器节点直接执行失败
• 运动模块有版本与底模的强绑定关系：SD1.5 系列的运动模块只配 SD1.5 底模，SDXL 需用对应的 SDXL 运动模块（如 mm_sdxl_v10_beta），混用会出错误结果或加载失败
• 同一 custom_nodes 下同时存在 ComfyUI-AnimateDiff-Evolved 与旧版 AnimateDiff 节点包时，class_type 重名会导致加载混乱

解决步骤

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

1. 下载运动模块并放进正确目录
   从运动模块官方发布页（guoyww/animatediff 的 Hugging Face 仓库）下载 mm_sd_v15_v2.ckpt（SD1.5 用）。放进 ComfyUI/models/animatediff_models；如果节点是旧版读 models/animatediff，则放进该目录，或两处都放一份以兼容。放完完全重启 ComfyUI，节点下拉框才会刷新。
2. 核对运动模块与底模版本是否配套
   SD1.5 底模配 mm_sd_v15_v2 系列；SDXL 底模必须用 SDXL 专用运动模块。用错版本时常见结果是画面崩坏、运动幅度异常或直接报错。先确认底模是 1.5 还是 XL，再挑对应运动模块。
3. 补齐 AnimateDiff 节点的 Python 依赖并确认只装一份
   Cloned 的 AnimateDiff 节点包也有自己的依赖，用便携版内置解释器装它的 requirements；同时检查 custom_nodes 下是否同时存在新旧两个 AnimateDiff 包，重复安装会导致节点冲突，建议只保留 AnimateDiff-Evolved 并删掉旧包（删前先备份工作流）。
   cd ComfyUI\custom_nodes\ComfyUI-AnimateDiff-Evolved
   ..\..\python_embeded\python.exe -m pip install -r requirements.txt
4. 重启后先用官方示例工作流验证最小可用组合
   装好后不要直接上复杂工作流，先用节点仓库 README 里的基础用法（底模 + AnimateDiff Loader + 运动模块 + 采样器）跑一次 16 帧小分辨率，确认环境通了再加载自己的复杂工作流。这样能把环境问题和参数问题分开。

验证是否修好

补充说明

error_text 取自 Comfy-Org/ComfyUI issue #1840 标题原文（标题即 'Error occurred when executing ADE_AnimateDiffLoaderWithContext:'，原标题末尾的冒号后无内容，说明 loader 执行失败是该 issue 的核心现象）。运动模块具体文件名 mm_sd_v15_v2.ckpt 与 SDXL 运动模块命名来自社区下载指引页面；ComfyUI 内该目录的确切名称（animatediff_models 还是 animatediff）随节点版本不同，已在步骤中给出两种写法而不断言唯一正确。

来源

1. [249] （官方 issue）　Error occurred when executing ADE_AnimateDiffLoaderWithContext:　https://github.com/Comfy-Org/ComfyUI/issues/1840
2. [250] （节点仓库 issue）　horrible results when using sd 1.5　https://github.com/guoyww/AnimateDiff/issues/40
3. [251] （中文社区）　AnimateDiff的motion module和base model分别在哪下载？　https://ask.csdn.net/questions/9220249

本条报错提到的节点仓库

下面这些节点仓库的名字出现在本条报错的正文里。这里只说「名字出现过」，没有断定问题就是它引起的； 点进去可以看这个包的用途、适配模型与下载量。

这条报错要用到的东西

按本条报错所属的类别（热门自定义节点/工作流专有报错）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库