常见问题 #

本页收录阿花 AI 安装、Docker、显卡、模型服务与视频生成过程中的常见问题。

执行 wsl --update 后仍然异常 #

以管理员身份打开 PowerShell：

wsl --update
wsl --shutdown
wsl --status

然后重启 Windows，再打开 Docker Desktop。若仍失败，检查 Windows 更新是否完整安装，并确认 BIOS 虚拟化已启用。

Docker Desktop 启动失败 #

常见原因包括 WSL2 异常、虚拟化未启用、Docker 数据损坏或 Windows 功能缺失。

处理步骤：

wsl --shutdown
wsl --update

然后打开“启用或关闭 Windows 功能”，确认已启用：

• 适用于 Linux 的 Windows 子系统
• 虚拟机平台
• Windows Hypervisor Platform

重启后再启动 Docker Desktop。

NVIDIA 驱动问题 #

如果 nvidia-smi 无法执行，或 Docker 容器无法识别 GPU，请重新安装 NVIDIA Studio Driver。

验证命令：

nvidia-smi
docker run --rm --gpus all nvidia/cuda:12.1.0-base-ubuntu22.04 nvidia-smi

镜像拉取失败 #

可能原因：

• 网络不稳定。
• Docker Desktop 未登录。
• 授权未成功，无法获取镜像凭证。
• 私有仓库访问凭证已过期。

建议操作：

docker logout
docker system df
docker pull <image-name>

生产环境中，镜像凭证由 flower-license 授权成功后返回，flower-shine 完成登录、拉取与登出流程。

显存不足 #

表现包括任务失败、容器退出、生成卡住或 CUDA out of memory。

处理建议：

• 关闭占用显存的软件。
• 降低视频分辨率。
• 减少 segmentFrames。
• 避免同时运行多个生成任务。
• 使用 RTX3060 12GB 或更高显存显卡。

WebSocket 断开 #

WebSocket 断开会导致任务面板不刷新，但不一定代表任务已失败。

检查步骤：

1. 确认 flower-shine 正常运行。
2. 刷新客户端页面或重新登录。
3. 查看本地日志目录：

Aflower/logs

4. 确认服务端仍在推送 task_status。

comfy-lipsync 启动失败 #

常见原因：

• Docker Desktop 未运行。
• 显卡驱动或 CUDA 运行环境异常。
• ComfyUI 自定义节点依赖缺失。
• 模型目录未挂载或模型文件不存在。
• 端口 8189 被占用。

检查命令：

docker ps -a
docker logs comfy-lipsync
netstat -ano | findstr 8189

生成视频卡死 #

可能发生在模型加载、显存不足、工作流节点等待输入或 WebSocket 状态未刷新时。

建议按顺序处理：

1. 等待首次模型加载完成，首次启动通常较慢。
2. 查看任务面板是否仍有进度。
3. 查看 Docker 容器日志。
4. 检查显存：

nvidia-smi

5. 降低分辨率或分段数后重新生成。

客户端打开后白屏 #

可能是本地 flower-shine 未启动成功。请检查：

• 是否从完整 release 目录启动。
• A-Zhao/resources/flower-shine.jar 是否存在。
• 内置 JRE 是否存在。
• 端口 12324 是否被占用。

netstat -ano | findstr 12324