[bug]: Corrupted File Causing Software Lock

问题场景

用户在 Linux 系统上手动安装并启动 InvokeAI 6.14.0，GPU 为 RTX 3090。软件在启动阶段对图片库进行整理时，遇到一张不完整或损坏的图片文件，导致整理进程无法完成，界面卡住，生成功能被锁定且无法正常使用。

报错原文

[bug]: Corrupted File Causing Software Lock

原因分析

可能原因是图片库中存在一张不完整或损坏的图片文件。InvokeAI 启动时会对图片库执行整理操作，当读取到该损坏文件时无法正常解析，导致整理进程悬挂。为了不破坏其余图片库数据，InvokeAI 会暂时阻止新的生成任务，直到整理进程被清除。

需要特别注意的是：仅删除损坏的图片文件并不能解决问题——未完成的整理进程仍会存在，InvokeAI 会继续认为库中还有一张实际已不存在的图片，从而保持卡死状态。

环境排查

• 确认 InvokeAI 版本为 6.14.0（bug 将在 6.14.1 修复）。
• 检查 CUDA 版本为 12.8、显卡驱动正常（RTX 3090）。
• 确认浏览器为 Chrome，排除前端渲染导致的假死。
• 核对图片库路径下是否有最近导入的图片，尤其是传输中断、磁盘写入异常或来自外部设备的文件。
• 检查是否有备份机制，可对照原图文件名查找对应备份。

解决步骤

1. 定位损坏文件：在 InvokeAI 图片库目录中查找最近添加或传输的图片文件，优先检查导入过程中可能中断的文件（文件大小异常、扩展名不匹配等）。
2. 尝试恢复原文件：如果有备份副本，将备份的原始图片文件恢复到其在图片库中的原始位置，替代损坏文件。这是最安全的方案，InvokeAI 可以正常完成库整理。
3. 通过 InvokeAI 正常删除图片：库整理完成后，如果不再需要这张图，请在 InvokeAI 界面内正常删除该图片，而不是在文件系统中直接删除。
4. 临时应急方案（可优先尝试）：如果没有备份，可找一张其他图片重命名为损坏文件的名称，替换到原位置。这有可能让 InvokeAI 完成启动，但该图片会附带错误的元数据，只能作为临时恢复手段。启动后应尽快通过 InvokeAI 删除该占位图，再重新导入正确的图片。
5. 等待官方修复：官方已确认此问题为 bug，计划在 InvokeAI 6.14.1 中修复。如果您可以暂时绕过该问题，建议等待升级。

验证方法

完成上述恢复或占位操作后，重新启动 InvokeAI，确认启动过程不再卡住，界面正常加载，图片库整理完成，并且可以正常执行生成任务。在 InvokeAI 中确认之前卡住的整理进程已清除，图片显示正常。

参考来源

invoke-ai/InvokeAI #9544

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。