df1856d793
- 产品编辑入口统一走 ProductFormFull(卖点/风格/人群/品牌词全字段); 修复开任务页 <form> 套 <form> 致"编辑产品"报错、改不了、跳回首个产品 - dashboard 入口卡片对齐实际路由: 系统管理(/config) 与 工作配置(/settings) 分开; settings ?tab=products 直达改用挂载后读 URL, 消除 hydration mismatch - 新增用户管理(users API/admin service/改密页) + alembic 022/023/024 - 上线部署: Dockerfile / docker-compose.prod+https / nginx https / .env.example - A8 三套正交叙事(痛点/场景/成分背书) + beige 调色去AI化 + 飞轮 text_import 高权重信号 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
53 lines
1.2 KiB
Markdown
53 lines
1.2 KiB
Markdown
# Clover 排障手册
|
|
|
|
## 服务不可访问
|
|
|
|
```bash
|
|
docker compose -f docker-compose.prod.yml ps
|
|
docker compose -f docker-compose.prod.yml logs --tail=100 nginx
|
|
curl -I http://127.0.0.1/
|
|
```
|
|
|
|
## 后端异常
|
|
|
|
```bash
|
|
curl http://127.0.0.1/health
|
|
docker compose -f docker-compose.prod.yml logs --tail=200 api
|
|
docker compose -f docker-compose.prod.yml logs --tail=200 worker
|
|
```
|
|
|
|
## SSE 没有实时进度
|
|
|
|
检查 nginx 是否关闭缓冲：
|
|
|
|
```bash
|
|
curl -N -H "Accept: text/event-stream" "http://127.0.0.1/api/v1/tasks/<task_id>/stream?ticket=<ticket>"
|
|
```
|
|
|
|
应能持续收到 named event。nginx 配置必须包含 `proxy_buffering off` 和 `X-Accel-Buffering: no`。
|
|
|
|
## 图片显示 404
|
|
|
|
```bash
|
|
docker compose -f docker-compose.prod.yml exec api ls -lah /app/uploads
|
|
docker compose -f docker-compose.prod.yml exec worker ls -lah /app/uploads
|
|
curl -I http://127.0.0.1/uploads/<path>
|
|
```
|
|
|
|
api 和 worker 必须共享同一个 `uploads` volume。
|
|
|
|
## 生成失败
|
|
|
|
常见原因：
|
|
|
|
- 客户未录入 API Key。
|
|
- provider key 余额不足或无权限。
|
|
- 上游中转站 429/503。
|
|
- 产品入镜但未上传产品图。
|
|
|
|
查看 worker 日志：
|
|
|
|
```bash
|
|
docker compose -f docker-compose.prod.yml logs --tail=200 worker
|
|
```
|