fix(ingest-jobs): GET /{job_id} 查不到时返回 404 而非 500 #1553

Merged

xiaoxia merged 2 commits from fix/ingest-jobs-404-not-found into develop 2026-08-30 12:00:08 +08:00

Conversation 5 Commits 2 Files Changed 2

+85 -2

xiaoxia commented 2026-08-30 11:27:51 +08:00

Owner

Copy Link

Copy Source

改动

apps/api/app/api/routes/ingest_jobs.py 的 GET /{job_id}：job 不存在时当前 raise ValueError(...) 被全局异常处理器映射成 500，客户端拿不到合理的「未找到」语义。改为 raise HTTPException(status_code=404, detail=...)。

测试

新增 tests/unit/test_ingest_jobs_route_404.py：

• test_get_ingest_job_not_found_returns_404：repo.get 返 None → 404，detail 含 job_id
• test_get_ingest_job_found_returns_200：repo.get 返 IngestJob 实体 → 200 + 字段完整

全量单测 13907 passed, 16 skipped。

## 改动 `apps/api/app/api/routes/ingest_jobs.py` 的 GET `/{job_id}`：job 不存在时当前 `raise ValueError(...)` 被全局异常处理器映射成 500，客户端拿不到合理的「未找到」语义。改为 `raise HTTPException(status_code=404, detail=...)`。 ## 测试 新增 `tests/unit/test_ingest_jobs_route_404.py`： - `test_get_ingest_job_not_found_returns_404`：repo.get 返 None → 404，detail 含 job_id - `test_get_ingest_job_found_returns_200`：repo.get 返 IngestJob 实体 → 200 + 字段完整 全量单测 13907 passed, 16 skipped。

xiaoxia added 1 commit 2026-08-30 11:27:51 +08:00

fix(ingest-jobs): GET /{job_id} 查不到时返回 404 而非 500 ValueError ... 1f9236bb16

之前 job 不存在抛 ValueError，被全局异常处理映射到 500，导致客户端拿不到合理的
'未找到'语义。改为 HTTPException(404)。

补 GET 路由单测：不存在→404、存在→200 + 字段完整。

gitea-actions bot commented 2026-08-30 11:32:30 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot added 1 commit 2026-08-30 11:38:45 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] b69588f14d

auto-approve-bot commented 2026-08-30 11:43:27 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

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

📊 审查概览

• 整体评价：通过
• 建议级问题数量：0 个

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

无

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

无

✅ 良好实践

1. [apps/api/app/api/routes/ingest_jobs.py] 正确使用 HTTPException 替代 ValueError，符合 FastAPI 框架规范，确保资源未找到时返回标准的 HTTP 404 状态码，而非 500 内部服务器错误。
2. [tests/unit/test_ingest_jobs_route_404.py] 新增了针对 404 场景的单元测试，有效覆盖了资源不存在的边界条件，提高了代码的健壮性和可维护性。
3. [tests/unit/test_ingest_jobs_route_404.py] 测试代码中正确使用了 app.dependency_overrides 进行依赖注入的 Mock，这是测试 FastAPI 路由的最佳实践，确保了测试的隔离性和准确性。

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-30 03:43:27 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：0 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 无 ### ✅ 良好实践 1. **[apps/api/app/api/routes/ingest_jobs.py]** 正确使用 `HTTPException` 替代 `ValueError`，符合 FastAPI 框架规范，确保资源未找到时返回标准的 HTTP 404 状态码，而非 500 内部服务器错误。 2. **[tests/unit/test_ingest_jobs_route_404.py]** 新增了针对 404 场景的单元测试，有效覆盖了资源不存在的边界条件，提高了代码的健壮性和可维护性。 3. **[tests/unit/test_ingest_jobs_route_404.py]** 测试代码中正确使用了 `app.dependency_overrides` 进行依赖注入的 Mock，这是测试 FastAPI 路由的最佳实践，确保了测试的隔离性和准确性。 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-30 03:43:27 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

auto-approve-bot approved these changes 2026-08-30 11:50:36 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-08-30 11:50:38 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

xiaoxia merged commit 4f7746926c into develop 2026-08-30 12:00:08 +08:00

gitea-actions bot commented 2026-08-30 12:03:42 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

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#1553