导出卡在最后一步，通常不是单一原因。进度条接近完成时，编码多半已经结束，剩下的是封装和写文件：封装阶段要把索引、容器头写回去，写文件阶段要真正占用磁盘。判断顺序建议是先看日志停在哪个动作上，再决定查参数组合还是查输出目录，避免一上来就反复改编码器。
把“卡在最后一步”拆成编码、封装、写盘三段，用日志最后一行动作定位段位；若停在写文件，先用 df -h、df -i 和 touch 测试排除空间、inode、权限问题；若停在封装或编码末尾，再核对编码器、码率、容器三项组合是否被当前版本支持；最后用同参数重跑加短片段对照确认改动有效。
在任务日志里定位卡住的具体阶段
先把日志窗口拉到最后一屏，看最后一条输出是什么形态。DramaClaw 这类导出工具的日志一般会混着三类行：编码帧进度、封装动作、文件写入动作。下面只是形态示意，不是某个版本的原始日志，重点看关键词落在哪一类。
[encode] frame 1830/1830 done
[mux] writing container index
[write] open output file ...
[write] flush 0%判读方法比较直接：最后一行仍是 frame x/y 且 x 长时间不动，说明卡在编码阶段，与输出目录关系不大；最后一行出现 mux、container、index 一类字样后不再推进，说明卡在封装阶段，优先怀疑容器与音视频轨的组合；最后一行出现 open、write、flush、close、fsync，或者干脆没有任何后续输出，说明已经进入写盘阶段，这时空间和权限才是主要嫌疑。
还有一种常见情况是日志最后一行是进度百分比但不再刷新，同时界面上的“正在写入”状态没变。这种情况不能只按百分比判断，需要结合任务管理器或系统层面看进程是否还有磁盘 IO。适用场景是所有卡在 99% 附近的导出；风险边界是日志级别太低时可能看不到写盘细节，需要先把日志级别调到详细再复现一次。
用系统命令确认输出目录的空间与权限
写盘失败是这类问题里最容易排除也最容易被忽略的一类。在导出机器上打开终端，先确认输出目录所在分区的剩余空间和 inode：
df -h /path/to/output
df -i /path/to/output看 df -h 输出里 Mounted on 对应那一行的 Avail 和 Use% 两列，Avail 接近 0 就是空间不足；df -i 看 IUsed 与 IFree，IFree 为 0 时即使还有空间也写不进新文件。临时目录同样要查一遍，很多导出工具会先写临时文件再改名，临时目录满了表现也是卡在最后一步。
ls -ld /path/to/output
touch /path/to/output/.dramaclaw_write_test
rm -f /path/to/output/.dramaclaw_write_testls -ld 看属主和权限位，确认当前运行导出任务的用户对目录有写权限；如果程序以服务或独立用户身份运行，用当前登录用户测试通过并不代表任务用户能写。touch 返回 “Permission denied” 就是权限问题，返回成功也不等于完整结论，还要确认目录没有挂载为只读，可以看 mount 输出里该挂载点是否带 ro 标记。这一步的操作动作很小，但能直接排掉最常见的写盘失败原因。
核对导出参数里的编码器、码率与容器组合
如果日志明确停在封装阶段，或者写盘检查全部正常但仍然失败，就该回到参数本身。末尾失败常见于三类组合：硬件编码器配了它不支持的像素格式或容器；码率填了 0、留空或超出界面允许范围；容器选了 MP4 但音轨编码不被该容器接受。下面是一份通用配置骨架，字段名称以你实际界面为准，不要按这里的字面去猜接口。
编码器: 软件 H.264（先不用硬件编码器做排除）
码率: 固定码率，给一个界面允许范围内的正常值
容器: MP4
输出路径: 本地磁盘目录，路径不含空格和特殊字符用法是先固定容器和输出路径，只把编码器从硬件切到软件，或者只把码率从可变改成固定，一次只改一个变量。改动后重新导出同一段素材，观察日志是否越过封装那一行。适用场景是日志停在 mux 或 encode 末尾；风险边界是软件编码速度明显更慢，它只用于定位，不适合直接当成长期配置，确认问题后再逐项换回并验证。
把长任务切成短片段验证是否与时长相关
同一份素材，用剪辑或命令行截取前 10 到 30 秒，用完全相同的导出参数跑一次，并记录结果：成功、失败、卡在哪一行。这一步是为了区分稳定复现的配置问题和与素材体量相关的问题。
如果短片段成功、完整素材仍卡在最后一步，方向就偏向长时间运行带来的累积因素，例如临时文件持续增长、磁盘在导出过程中被其它任务占满、内存或显存压力在末尾升高。如果短片段同样卡住且日志最后一行一致，说明问题跟着参数或目录走，与时长无关，回到前面两节检查。对照记录建议写清三件事：截取范围、参数是否完全一致、失败时日志最后一行。风险边界是截取工具本身可能改变音视频参数，截取后先确认轨道信息一致再对比，否则结论不可靠。
同参数重跑并比对日志完成验证
改完某一项之后不要直接下结论，按固定步骤重跑一次：先清掉输出目录里上次残留的临时文件和半成品，确认这次参数与上次失败时只差一个变量，然后启动导出并盯着日志最后几行。比对时重点看三处：封装那一行是否出现并顺利通过、写文件那一行是否出现 close 或完成字样、任务结束后进度是否到 100% 而不是停在末尾。
最后确认输出文件本身。检查文件大小不为 0，用播放器能正常打开并拖到结尾不报错，如果环境里有 ffprobe 一类工具，用它读取时长和轨道信息，与源素材对比是否一致。半成品文件往往大小正常但索引缺失，只能播放开头，这类情况在只看文件大小的检查里会被漏掉。确认无误后再把临时绕过的配置逐项换回，每换一项重跑一次，直到回到日常使用的参数组合。