mcpField
D
davinci-resolve-troubleshooting

davinci-resolve-troubleshooting

github.com/chaiwithjai创意与媒体3184 次安装23 周前更新
代码仓库

关于 davinci-resolve-troubleshooting

为 DaVinci Resolve 提供五类常见故障的诊断流程,适合处理播放掉帧、媒体离线、音画不同步及渲染问题。强调先定位原因,再按症状采取修复步骤。

主要功能

  1. 01诊断播放掉帧瓶颈
  2. 02重新链接离线媒体
  3. 03排查音画同步漂移
  4. 04分析渲染崩溃原因
  5. 05处理渲染队列停滞

适用场景

  1. 01播放指示灯变红时定位磁盘或 GPU 瓶颈
  2. 02项目迁移后恢复离线片段
  3. 03修复长时间线中的音频漂移
  4. 04渲染崩溃或输出文件缺失时排查

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/chaiwithjai/davinci-resolve-claude-skills --skill davinci-resolve-troubleshooting

安装后在 Claude Code 中输入/davinci-resolve-troubleshooting确认已加载。

详细介绍

DaVinci Resolve — 排查 5 种最常见的故障模式

概述

一份诊断协议,针对占 DaVinci Resolve 支持问题约 90% 的五类问题:播放丢帧、媒体丢失、音频同步漂移、渲染崩溃以及渲染队列停滞。原则是:先诊断,再修复。把红色指示器当作数据,而不是判决。

何时使用

症状:

  • 播放期间 GPU/播放指示器变红
  • 片段显示红色斜杠(媒体离线)
  • 音频随时间推移逐渐失步
  • Resolve 在渲染过程中或渲染几分钟后崩溃
  • 渲染队列显示"完成",但输出文件缺失或为 0 字节
  • "为什么 Resolve 里的 X 坏了" — 上述任何一种情况。

何时不使用:

  • Resolve 完全无法启动 — 这是安装问题(参见 davinci-resolve-setup)。
  • 你遇到许可证错误 — 请联系 Blackmagic 支持。
  • 问题属于创作层面("我不喜欢我的剪辑效果")— 这不是故障排查问题。

快速参考 — 五条诊断流程

症状首先检查然后
播放指示器变红在媒体驱动器上运行 Blackmagic Disk Speed Test如果驱动器速度足够,生成代理
片段离线(红色斜杠)右键片段 > Relink Media或更改媒体夹的源文件夹
音频失步确认时间线帧率与源帧率一致使用 Auto-Sync(波形或时间码)
渲染期间崩溃降低渲染并行度,禁用硬件加速检查 Console 中的确切错误
渲染队列停滞在 0%检查输出驱动器的磁盘空间检查 Custom Export 文件名是否含无效字符

步骤 — 每个问题的诊断流程

问题 1:播放指示器变红(丢帧)

当 Resolve 无法维持实时播放时,源/时间线监视器顶部的指示器会变红。

步骤 1.1 — 找出瓶颈。是驱动器还是 GPU?

  • 打开 DaVinci Resolve > Preferences > System > Memory and GPU。检查播放期间的 GPU 占用率。
  • 如果播放期间 GPU 低于 80%,瓶颈是驱动器(读取速度)。
  • 如果 GPU 一直处于 100%,瓶颈是 GPU(对口播内容很少见;4K + 重度调色时常见)。

步骤 1.2 — 如果瓶颈是驱动器,运行 Blackmagic Disk Speed Test:

  • 免费应用,从 Mac App Store(macOS)或 Desktop Video 安装程序(Windows)安装。
  • 将其指向你的媒体驱动器。查看 "Will It Work?" 表格。确认你的编解码器在你的分辨率和帧率下显示绿色对勾。
  • 如果驱动器无法维持所需的读取速度,你有两个选择:
    1. 将媒体移到更快的驱动器(NVMe SSD、Thunderbolt)。
    2. 生成代理(参见步骤 1.3)。

Editor's Guide 第 326 页详细介绍了 Blackmagic Disk Speed Test 的用法。

步骤 1.3 — 如果无法升级驱动器,就生成代理。

  • 在 Media Pool 中,右键片段 > Generate Proxy Media。
  • 选择代理格式:H.264 Half-Res 1080p 是编辑的良好默认选项。
  • 等待代理生成。
  • 将监视器顶部的 Proxy Handling 菜单切换为 Prefer Proxies。
  • 现在播放应该是绿色的。

步骤 1.4 — 交付前,切换回摄影机原始素材:

  • Proxy Handling > Prefer Camera Originals。Resolve 会从高质量源渲染,而不是代理。

Editor's Guide 第 324-337 页涵盖了完整的代理工作流,包括独立的 Blackmagic Proxy Generator 应用。

这纠正的误解:"红色指示器意味着我的电脑太慢。"通常它意味着驱动器太慢,而不是 GPU。先诊断。

问题 2:片段离线(红色斜杠)

媒体池或时间线中片段缩略图上出现红色斜杠,表示 Resolve 无法在索引时所记录的路径找到源文件。

步骤 2.1 — 判断是单个片段还是所有片段。

  • 如果某个媒体夹中的所有片段都离线,说明源文件夹已被移动或驱动器已卸载。
  • 如果只有一两个片段离线,说明这些特定文件已被移动或重命名。

步骤 2.2 — 对于所有片段离线的情况(典型案例:项目被移动到新机器):

  • 右键点击受影响的媒体夹 > 更改源文件夹。
  • 浏览到此机器上媒体当前的实际位置。
  • 点击更改。该媒体夹中的所有片段将在一次操作中重新链接。

Editor's Guide 第 336 页展示了片段操作 > 更改源文件夹。

步骤 2.3 — 对于个别离线片段:

  • 右键点击片段 > 重新链接所选片段。
  • 浏览到该文件。Resolve 仅重新链接该片段。

步骤 2.4 — 如果文件确实已不存在:

  • 检查你的备份文件夹(davinci-resolve-setup 涵盖了备份文件夹位置)。
  • 或者如果你可能已将其删除,请检查 ~/.Trash / 回收站。
  • 如果文件确实已丢失,你可能需要重新拍摄或从源重新导出。
问题 3:音频逐渐失去同步

音频在开始时同步,但随时间逐渐偏移(例如 10 分钟后偏移 1 秒)。

步骤 3.1 — 确认源片段的帧率与时间线帧率一致。

  • 在媒体池中右键点击源片段 > 片段属性。
  • 记录片段的帧率。
  • 文件 > 项目设置 > 主设置 > 时间线帧率。确认两者一致。
  • 如果两者不同(例如片段为 29.97 fps 但时间线为 24 fps),Resolve 将以不同方式解读音频。这是偏移最常见的原因。

步骤 3.2 — 检查音频采样率。

  • 片段属性 > 采样率(通常为 48000 Hz)。
  • 项目设置 > 主设置 > 采样率。使两者匹配。

步骤 3.3 — 如果视频和音频是分开录制的(双系统音频),请重新同步它们。

  • 在媒体池中,同时选择视频和音频片段。
  • 右键点击 > 自动同步音频。
  • 选择基于波形(无需时间码即可工作)或基于时间码(如果两者都有匹配的时间码则更快)。
  • Resolve 会将这两个片段对齐为单个同步片段。

Editor's Guide 第 267-277 页涵盖了音频同步工作流。

步骤 3.4 — 对于由硬件时钟漂移(例如外部录音设备与摄像机之间)引起的偏移:

  • 使用检查器中音频片段上的拉伸参数进行微小幅度(0.5% 或更少)的减速/加速。
  • 或者将音频分割为多个部分,并重新同步每个部分。
问题 4:Resolve 在渲染期间崩溃

步骤 4.1 — 检查控制台以获取实际错误。

  • 工作区 > 控制台打开控制台面板。
  • 查看崩溃前的最后几条消息。常见原因:
    • "内存不足" — 降低渲染帧率或关闭其他应用
    • "GPU 错误" — 禁用硬件解码(见 4.2)
    • "文件系统错误" — 磁盘已满或驱动器已断开

步骤 4.2 — 如果看到 GPU 错误,请禁用硬件加速。

  • 偏好设置 > 解码选项 > 取消勾选使用硬件加速解码 H.264/H.265。
  • 这会较慢但更稳定,尤其是在较旧或混合 GPU 的系统上。

步骤 4.3 — 降低渲染并发。

  • 某些 Resolve 在渲染期间的崩溃是由于尝试同时使用两个 GPU(在双 GPU 机器中)导致的。
  • 偏好设置 > 系统 > 内存和 GPU > 将 GPU 处理模式明确设置为 CUDA 或 Metal(而非自动)。
  • 重启 Resolve。

步骤 4.4 — 释放磁盘空间。

  • 渲染在处理期间需要源文件大小 2-3 倍的暂存空间。
  • 检查你的媒体驱动器和输出驱动器都至少有 50 GB 可用空间。
问题 5:渲染队列卡在 0%

渲染显示 “Render in Progress”,但磁盘上的文件大小没有增长。

步骤 5.1 — 检查输出文件名是否包含无效字符。

  • macOS 文件系统不允许文件名中出现 :。Windows 不允许 < > : " / \ | ? *。
  • 如果你的渲染预设包含 %timeline_name,并且你的时间线名称包含冒号或斜杠,渲染会静默失败。
  • 先重命名时间线,或者将 Custom Export 文件名改为使用普通字符。

步骤 5.2 — 确认输出文件夹存在且可写。

  • 检查 Render Settings 中的 Location 字段。在 Finder/Explorer 中手动浏览到该位置。
  • 如果它不存在,请创建它。
  • 如果它存在但属于其他用户,请更改权限或选择其他位置。

步骤 5.3 — 缩小渲染帧范围。

  • 如果某个特定片段已损坏,渲染会卡在该帧。
  • 在 Render Settings 中,将 Render 从 “Entire Timeline” 改为 “In/Out Range”,并在疑似问题帧之前设置一个 Out 点。
  • 如果这样能完成,就每次向后推进几秒钟,以找到问题帧。

步骤 5.4 — 重启 Resolve。

  • 如果以上方法都失败,请强制退出 Resolve(macOS 上使用 Force Quit,Windows 上使用 Task Manager)并重新打开项目。渲染队列经常会在长时间会话后卡住,重启可以清除该问题。

常见错误

  • 假定红色指示器 = 旧电脑 -> 通常问题出在硬盘,而不是 GPU。先使用 Blackmagic Disk Speed Test 进行诊断。(这正是本技能正面解决的误解。)
  • 重新导入离线片段,而不是重新链接 -> 如果重新导入,你会丢失所有编辑。务必重新链接。
  • 让 Resolve 在双 GPU 系统中自动选择 GPU -> 手动明确设置为 CUDA 或 Metal。自动选择可能导致崩溃。
  • 用冒号或斜杠命名时间线 -> 渲染会静默失败。请坚持使用字母数字、下划线、短横线。

验证

如果以下所有条件都成立,则说明你成功了:

  1. 在时间线的 30 秒播放过程中,播放指示器为绿色。
  2. Media Pool 中的每个片段都有缩略图(不是红色斜线)。
  3. 音频波形在整个时间线中与视频动作对齐(场记板上的拍手声与场记板画面匹配;嘴部动作与语音匹配)。
  4. 渲染完成,并且输出文件的大小和时长符合预期。
  5. 你可以按名称指出 5 个问题中适用的是哪一个(或者没有适用的问题)。

迁移

现在,当你遇到新的故障模式时,试试这个方法——比如,一个无法正确渲染的 Fusion 合成。应用同样的诊断协议:(1) 精确识别症状,(2) 检查 Console 中是否有实际错误消息,(3) 缩小范围(只渲染那一个 Fusion 合成片段)以隔离原因,(4) 先在副本上测试修复,再应用到项目。这种解决问题的纪律可以扩展到上述五个案例之外。

工作参考

  • docs/wiki/editors-guide.md#lesson-6--ai-workflows-pp-323-387(Disk Speed Test、代理、重新链接工作流 — 主要)
  • docs/wiki/editors-guide.md#lesson-5--project-organization-pp-245-321(音频同步、帧率匹配)
  • docs/wiki/colorist-guide.md#lesson-8--adjusting-image-properties-pp-343-379(用于 Color 页面播放的 Render Cache)
  • docs/wiki/master.md#reset-matrix--when-the-user-pushes-back-read-this(每一行故障排除症状都映射到这里)

当 Agent 的工作不符合预期时(上下文腐化重置)

如果用户反馈诊断流程未能解决问题(红色回放再次出现、片段仍然离线、渲染仍然失败),请阅读以下 PDF 页面范围进行重置:

  • DaVinci-Resolve-20-Editors-Guide.pdf 第 326 页(Is Your Drive Fast Enough? — Blackmagic Disk Speed Test)
  • DaVinci-Resolve-20-Editors-Guide.pdf 第 324-340 页(Generating Proxy Files — 完整工作流,包括 Blackmagic Proxy Generator)
  • DaVinci-Resolve-20-Editors-Guide.pdf 第 336 页(Change Source Folder,用于批量重新链接)
  • DaVinci-Resolve-20-Editors-Guide.pdf 第 267-277 页(Syncing Audio to Video 与 Channel Configuration)
  • DaVinci-Resolve-20-Editors-Guide.pdf 第 597-617 页(Customizing Deliver Presets,渲染失败原因)
  • DaVinci-Resolve-20_Beginners-Guide.pdf 第 6-8 页(Relinking the Media Files)
  • DaVinci-Resolve-20_Beginners-Guide.pdf 第 350-364 页(Syncing Audio to Video)
  • DaVinci-Resolve-20-Colorist-Guide.pdf 第 369-377 页(Optimizing Performance with Render Cache — 用于调色页面回放)

评论

支持 Markdown