AE 导出 Lottie 失败——Bodymovin 报错或文件为空

插件面板打不开

原因 1：AE 没有安装允许脚本写入权限

AE CC 2019+ 默认关闭。解决：

编辑 → 首选项 → 常规 → 勾选"允许脚本写入文件和访问网络"

原因 2：CEP 版本不匹配

新版本 AE 用的 CEP 版本更高，如果 Bodymovin 的 manifest.xml 里 CEP 版本声明和你 AE 版本不匹配，面板可能打不开或显示空白。

解决：换和你 AE 版本匹配的 Bodymovin 版本。

原因 3：插件文件没放对位置

检查扩展目录：

• Windows：C:\Users\<用户名>\AppData\Roaming\Adobe\CEP\extensions\bodymovin\
• macOS：~/Library/Application Support/Adobe/CEP/extensions/bodymovin/

目录里必须有 CSXS/manifest.xml 文件。

点 Render 按钮没反应

原因：AE 版本权限

还是那个权限问题——脚本写入文件被拦截。在首选项里确认勾选了再试。

导出的 JSON 文件体积异常小（< 1KB）

这通常意味着 Bodymovin 没有成功解析你的合成。检查清单：

1. 合成里有没有非 3D 图层但用了 3D 属性？（z 轴位置、方向、摄像机）3D 图层目前不支持。
2. 图层名有没有包含特殊字符？emoji、全角符号、中文逗号分号都可能导致解析失败。把图层名改成纯英文 + 下划线再试。
3. 合成里有没有任何图层？空合成或只有调节图层会导致解析异常。
4. 有没有图层用了表达式但没 Convert to Keyframes？（某些表达式会让解析器直接放弃整个图层）

导出的 JSON 在 LottieFiles 预览器里渲染不完整

丢图层 / 图层不显示

对照 图层类型支持一览 检查你的合成里是否有：

• 位图 + Mask（不兼容）
• 调节图层（不兼容，需预烘焙）
• 3D 图层（不兼容）
• Luma Matte（不兼容）

颜色丢失或异常

• 渐变（Gradient）支持有限，太复杂的渐变可能丢失。
• 描边（Stroke）属性如果有虚线、端点样式等复杂设置，可能渲染不正确。
• 用纯色图层模拟的效果建议直接用形状图层。

动画不动 / 只停在第一帧

几乎总是表达式没预烘焙导致的。检查你所有图层属性：

1. AE 里选中图层，展开 Transform / Contents 属性。
2. 看每个属性左边有没有 ⌥（alt）图标——有就是用了表达式。
3. 选中所有带表达式的属性 → 右键 → "Convert Expression to Keyframes"。
4. 等 AE 把所有表达式展开成关键帧（复杂表达式可能要几秒），再重新导出。

这是 Lottie 最常见的坑——AE 里动效好好的，导出后"死"了，90% 是这个原因。

建议工作流

养成"导出 → 拖进预览器 → 看渲染"的三步习惯：

1. 每次导出完，立刻把 JSON 拖到 LottieFiles 在线预览器。
2. 如果预览器里就有问题，到各平台 SDK 上也肯定有问题。
3. 在 AE 里改，别等到开发集成阶段才发现。