feat(backend): 重构 HTTP 错误处理为 RFC7807 标准并优化多个 service

backend/src/core/http/errors.py

@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+from typing import Any
+
+
+class ApiProblemError(Exception):
+    def __init__(
+        self,
+        *,
+        status_code: int,
+        detail: str | dict[str, Any],
+        code: str | None = None,
+        params: dict[str, Any] | None = None,
+    ) -> None:
+        resolved_detail = detail
+        resolved_code = code
+        resolved_params = params
+
+        if isinstance(detail, dict):
+            payload = detail
+            resolved_code = resolved_code or str(
+                payload.get("code") or "INTERNAL_ERROR"
+            )
+            resolved_detail = str(payload.get("detail") or "Request failed")
+            raw_params = payload.get("params")
+            if resolved_params is None and isinstance(raw_params, dict):
+                resolved_params = raw_params
+
+        if not isinstance(resolved_detail, str):
+            resolved_detail = str(resolved_detail)
+        if not resolved_code or not isinstance(resolved_code, str):
+            resolved_code = "INTERNAL_ERROR"
+
+        super().__init__(resolved_detail)
+        self.status_code = status_code
+        self.code = resolved_code
+        self.detail = resolved_detail
+        self.params = resolved_params
+
+
+def problem_payload(
+    *,
+    code: str,
+    detail: str,
+    params: dict[str, Any] | None = None,
+) -> dict[str, Any]:
+    payload: dict[str, Any] = {"code": code, "detail": detail}
+    if params:
+        payload["params"] = params
+    return payload

backend/src/core/http/response.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from http import HTTPStatus
+from typing import Any
 
 from pydantic import BaseModel
 
@@ -11,6 +12,8 @@ class ProblemDetails(BaseModel):
     status: int
     detail: str
     instance: str | None = None
+    code: str | None = None
+    params: dict[str, Any] | None = None
 
 
 def build_problem_details(
@@ -20,6 +23,8 @@ def build_problem_details(
     type_value: str = "about:blank",
     title: str | None = None,
     instance: str | None = None,
+    code: str | None = None,
+    params: dict[str, Any] | None = None,
 ) -> ProblemDetails:
     resolved_title = title or HTTPStatus(status_code).phrase
     return ProblemDetails(
@@ -28,4 +33,6 @@ def build_problem_details(
         status=status_code,
         detail=detail,
         instance=instance,
+        code=code,
+        params=params,
     )

backend/src/core/runtime/cli.py

@@ -7,10 +7,9 @@ from pathlib import Path
 
 from apscheduler.schedulers.blocking import BlockingScheduler
 from apscheduler.triggers.interval import IntervalTrigger
-
 from core.automation.scheduler import run_automation_scheduler_scan
-from core.config.settings import config
 from core.config.initial.init_data import initialize_data
+from core.config.settings import config
 from core.logging import get_logger
 
 logger = get_logger("core.runtime.cli")
@@ -107,10 +106,6 @@ async def bootstrap() -> bool:
 
 
 async def run_automation_scheduler_forever() -> None:
-    if config.runtime.environment == "dev":
-        logger.info("Automation scheduler skipped in dev environment")
-        return
-
     if not config.automation_scheduler.enabled:
         logger.info("Automation scheduler disabled by config")
         return