Qwen-Image生成卡在99%失败是因BF16模式下显存预留冲突导致最终帧写入异常，需关闭「启用显存预分配」、将预留比例调至50%、清空~/.cache/qwen-image/denoise_cache/并添加--sync-save参数重启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
千问AI生成图片进度卡在99%后突然报错失败，不是网络中断也不是显存不足，而是模型在最终去噪阶段遭遇数值溢出或缓存写入异常，此时图像已基本成型但无法完成像素校验与文件封装。
检查GPU显存缓冲区是否被意外截断
进入Web界面右下角「高级设置」→关闭「启用显存预分配」开关→将“显存预留比例”从默认70%调至50%→点击「应用并重启生成」。
这一步必须做：Qwen-Image在BF16模式下会为最终帧预留固定大小的显存块，若系统后台有其他进程（如浏览器视频解码、桌面特效）临时抢占显存，会导致最后一帧写入失败。调低预留比例可避开冲突区域。
验证输出路径权限与磁盘空间
方法一：直接查看日志末尾报错行
在浏览器开发者工具（F12）→Console标签页中，滚动到底部查找含“write failed”或“no space left”的红色错误信息。
方法二：手动测试写入能力
打开终端，执行：echo "test" > /tmp/qwen_test.txt && rm /tmp/qwen_test.txt。若提示Permission denied，说明当前用户对默认缓存目录无写入权；若提示No space left，需清理/tmp或/var/tmp分区。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
【关键前提】Qwen-Image默认将中间帧写入/tmp，而非项目根目录。很多用户误以为只要自己项目目录有空间就行，其实根本没走到那一步。
强制刷新去噪缓存并重试生成
第一步：停止当前服务进程
在终端中执行pkill -f "qwen-image"，确保所有相关Python进程已退出。
第二步：清空去噪缓存目录
运行rm -rf ~/.cache/qwen-image/denoise_cache/*，该目录存储每轮迭代的噪声残差，残留损坏缓存会引发99%阶段校验失败。
第三步：重启服务并禁用异步保存
启动命令末尾添加参数--sync-save，例如：python app.py --sync-save。这会让模型放弃分片写入策略，改用单次原子写入，避免因IO调度延迟导致封装中断。
