fix: 删除 worker entrypoint 中无效的 -W 参数，修复 worker 启动崩溃 #1337

Merged

xiaoxia merged 1 commits from fix/worker-entrypoint-w-flag into develop 2026-08-10 19:10:21 +08:00

Conversation 3 Commits 1 Files Changed 1

+1 -2

xiaoxia commented 2026-08-10 16:46:32 +08:00

Owner

Copy Link

Copy Source

问题

Worker 容器状态为 Restarting，日志显示 Error: No such option '-W'。

根因

PR #1333 在 entrypoint-worker.sh 末尾误加了 -W 参数，Celery 5.4.0 不支持此选项。

修复

删除 -W，恢复正确的 celery worker 启动命令。

## 问题 Worker 容器状态为 Restarting，日志显示 `Error: No such option '-W'`。 ## 根因 PR #1333 在 entrypoint-worker.sh 末尾误加了 `-W` 参数，Celery 5.4.0 不支持此选项。 ## 修复 删除 `-W`，恢复正确的 celery worker 启动命令。

gitea-actions bot commented 2026-08-10 16:49:54 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1337
预览链接	https://pr-1337.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1337 | | 预览链接 | [https://pr-1337.preview.xiaoxiajianji.com](https://pr-1337.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia added 1 commit 2026-08-10 19:01:33 +08:00

fix: 删除 worker entrypoint 中无效的 -W 参数，修复 worker 启动崩溃 ... 314579581b

Celery 5.4.0 不支持 -W 选项，导致 worker 容器反复重启（Restarting）。
此参数是 PR #1333 误加，删除后恢复正常的 graceful shutdown 行为。

xiaoxia force-pushed fix/worker-entrypoint-w-flag from d01b3d6fb7 to 314579581b 2026-08-10 19:01:33 +08:00 Compare

auto-approve-bot commented 2026-08-10 19:02:59 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

• 是否存在阻塞级问题：否
• 阻塞级问题数量：0 个

📊 审查概览

• 整体评价：有建议
• 建议级问题数量：：1 个

🔴 阻塞级问题（必须修复）

无

💡 改进建议（不阻塞合并）

1. [infra/docker/entrypoint-worker.sh: 移除 -W 参数] 确认预热参数移除的意图
   • 具体内容：在 Celery 中，-W 参数代表 --warmup，用于在 Worker 启动时预加载任务模块。移除此参数将禁用预热功能。虽然这可以加快容器启动速度，但会导致模块导入错误延迟到任务执行时才暴露，增加了线上排查问题的难度。如果本意是修改执行池（如使用 gevent/eventlet），正确的参数是 -P 而非移除 -W。请确认移除该参数是否符合预期。

✅ 良好实践

• 脚本使用了 exec 来启动 Celery，这确保了 Celery 进程能够替换当前的 shell 进程（PID 1），从而正确接收信号（如 SIGTERM）进行优雅退出，符合 Docker 容器的最佳实践。

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-10 11:02:59 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：有建议 - 建议级问题数量：：1 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 1. **[infra/docker/entrypoint-worker.sh: 移除 -W 参数] 确认预热参数移除的意图** - 具体内容：在 Celery 中，`-W` 参数代表 `--warmup`，用于在 Worker 启动时预加载任务模块。移除此参数将禁用预热功能。虽然这可以加快容器启动速度，但会导致模块导入错误延迟到任务执行时才暴露，增加了线上排查问题的难度。如果本意是修改执行池（如使用 gevent/eventlet），正确的参数是 `-P` 而非移除 `-W`。请确认移除该参数是否符合预期。 ### ✅ 良好实践 - 脚本使用了 `exec` 来启动 Celery，这确保了 Celery 进程能够替换当前的 shell 进程（PID 1），从而正确接收信号（如 SIGTERM）进行优雅退出，符合 Docker 容器的最佳实践。 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-10 11:02:59 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia merged commit e95d0c2bca into develop 2026-08-10 19:10:21 +08:00

gitea-actions bot commented 2026-08-10 19:10:59 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1337 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1337 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1337