xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 11 Pull Requests 2 Actions 1 Packages Projects Releases 7 Wiki Activity

fix(worker): 修复瘦身后shared模块无法导入的PYTHONPATH问题 #343

Merged
xiaoxia merged 1 commits from fix/worker-pythonpath into develop 2026-07-15 09:16:36 +08:00
Conversation 0 Commits 1 Files Changed 1
+1 -1
xiaoxia commented 2026-07-15 08:31:08 +08:00
Owner
Copy Link
Copy Source

问题

PR #340 Worker镜像瘦身后，develop分支的Worker容器启动失败：

ModuleNotFoundError: No module named 'shared'

根因

瘦身后的多阶段构建中，代码通过 COPY packages/ /app/packages/ 复制，shared模块位于 /app/packages/shared/。
但 PYTHONPATH=/app 只包含 /app，Python无法找到 packages 下的子模块。

API镜像结构相同但未触发该导入路径（API不直接import ffmpeg_utils等shared模块），所以未报错。

修复

将 ENV PYTHONPATH=/app 改为 ENV PYTHONPATH=/app:/app/packages，让Python同时在两个目录查找模块。

影响范围

  • Worker镜像启动
  • 不影响API/Web镜像
  • 镜像大小无变化（纯环境变量修改）

验证

CI Build Staging Worker Image成功后，Worker应能正常启动，E2E测试应通过。

## 问题 PR #340 Worker镜像瘦身后，develop分支的Worker容器启动失败： ``` ModuleNotFoundError: No module named 'shared' ``` ## 根因 瘦身后的多阶段构建中，代码通过 `COPY packages/ /app/packages/` 复制，shared模块位于 `/app/packages/shared/`。 但 `PYTHONPATH=/app` 只包含 `/app`，Python无法找到 `packages` 下的子模块。 API镜像结构相同但未触发该导入路径（API不直接import ffmpeg_utils等shared模块），所以未报错。 ## 修复 将 `ENV PYTHONPATH=/app` 改为 `ENV PYTHONPATH=/app:/app/packages`，让Python同时在两个目录查找模块。 ## 影响范围 - Worker镜像启动 - 不影响API/Web镜像 - 镜像大小无变化（纯环境变量修改） ## 验证 CI Build Staging Worker Image成功后，Worker应能正常启动，E2E测试应通过。
xiaoxia added 1 commit 2026-07-15 08:31:09 +08:00
fix(worker): 修复瘦身后PYTHONPATH缺少packages目录导致shared模块无法导入
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 1m26s
Details
CI/CD Pipeline / Unit Tests (pull_request) Successful in 1m40s
Details
CI/CD Pipeline / Validate Code Quality And Tests (pull_request) Successful in 1m43s
Details
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / Integration Tests (pull_request) Successful in 1m20s
Details
ea65033b01
xiaoxia merged commit 535e525a0e into develop 2026-07-15 09:16:36 +08:00
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
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#343
Delete Branch "fix/worker-pythonpath"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?