qbittorrent文件损坏需通过强制重校验定位异常，再按优先级仅修复被刮削修改的.nfo等小文件，必要时跳过哈希检查并用外部工具验证，docker环境还需恢复fastresume配置。
如果您在使用qBittorrent下载完成后发现文件无法打开、播放异常或提示“校验失败”，则很可能是文件在传输或存储过程中发生了损坏。qBittorrent本身不主动修复损坏数据，但可通过哈希校验机制识别异常，并结合优先级控制与选择性重下载实现精准修复。以下是解决此问题的步骤：
一、强制重新校验文件完整性
qBittorrent默认在下载完成时执行一次哈希校验，但若中途断电、磁盘写入异常或系统崩溃，可能导致校验未完成或结果缓存错误。强制重校验可触发全量哈希比对，定位真实损坏位置。
1、在任务列表中右键点击目标种子任务。
2、从弹出菜单中选择“强制重新检查”（Force Recheck）。
3、等待状态栏显示“检查中”，校验进度将实时更新，耗时取决于文件大小与磁盘读取速度。
4、校验结束后，若状态变为“正在做种”或“已完成”，说明文件完整；若仍显示“错误”或“丢失文件”，则需进入下一步排查。
二、调整文件下载优先级后选择性修复
当校验失败并非因主视频文件损坏，而是由刮削工具修改的.nfo、poster.jpg等小文件导致Hash值变更时，无需重新下载整个GB级文件。通过优先级干预，可仅让qBittorrent修复被篡改的小文件。
1、选中红种任务，切换至下方“内容”选项卡。
2、在文件列表中找到体积较大且实际可正常播放的主媒体文件（如movie.mkv），右键将其“下载优先级”设为不下载。
3、找到名称相同但修改时间较新的.nfo、fanart.jpg、clearlogo.png等小文件，右键逐一设为高或正常优先级。
4、再次右键任务，执行“强制重新检查”。此时qBittorrent将跳过已标记“不下载”的大文件，仅对高优先级小文件发起重下载与校验。
三、跳过哈希检查并手动验证关键文件
当原始种子元数据已不可信（如种子文件被编辑、Tracker失效），或您确认本地文件物理完整但qBittorrent持续报错时，可临时跳过哈希校验流程，直接启用做种，并辅以外部工具交叉验证。
1、右键任务 → “属性” → 勾选跳过哈希检查（Skip hash check）。
2、点击“确定”后，任务状态将立即变为“正在做种”，允许上传共享。
3、使用外部工具如QuickHash或命令行sha1sum对本地主文件计算Hash值。
4、将计算结果与原始种子文件中info字段的pieces哈希串进行比对（需解析.torrent二进制结构或使用torrentinfo工具），确认是否一致。
四、使用qui WebUI高级验证功能辅助诊断
qui作为qBittorrent现代化WebUI，提供更细粒度的验证控制能力，尤其适合多文件种子中快速定位异常项，避免全局误判。
1、确保已部署qui并连接至qBittorrent后端API。
2、在种子详情页点击“文件”标签，勾选疑似异常的单个文件（如001.nfo）。
3、点击右上角“操作”按钮 → 选择验证所选文件（Verify selected files）。
4、观察该文件单独校验结果：若失败，说明其内容确实与种子元数据不匹配；若成功，则问题可能出在其他未勾选文件或路径映射异常。
五、恢复Docker容器中损坏配置与种子记录
若qBittorrent运行于Docker环境，且下载目录完好但任务全部消失或反复报“文件丢失”，极可能是容器内fastresume或torrents配置文件损坏，而非媒体文件本身问题。
1、停止qbittorrent容器：docker stop qbittorrent。
2、进入宿主机配置挂载目录（如/volume1/docker/qbittorrent/config），检查fastresume文件夹内是否存在与种子Info Hash同名的.dat文件。
3、若存在但大小为0或时间戳异常，将其备份后删除；若torrents文件夹内缺失对应.torrent文件，从BT_backup中复制一份回torrents目录。
4、重启容器：docker start qbittorrent，随后在WebUI中右键任一任务执行强制重新检查，触发fastresume重建与文件映射重载。
