feat(platform-api): enforce request timeout

vehicle-data-platform/apps/api/internal/app/server.go

@@ -35,5 +35,12 @@ func NewServer(cfg config.Config) http.Handler {
 		}
 	}
 	api := platform.NewHandler(platform.NewService(store))
-	return static.Handler(cfg.StaticDir, api)
+	return withRequestTimeout(static.Handler(cfg.StaticDir, api), cfg.RequestTimeout)
+}
+
+func withRequestTimeout(next http.Handler, timeout time.Duration) http.Handler {
+	if timeout <= 0 {
+		return next
+	}
+	return http.TimeoutHandler(next, timeout, `{"error":{"code":"REQUEST_TIMEOUT","message":"请求处理超时"},"traceId":"timeout","timestamp":0}`)
 }

vehicle-data-platform/apps/api/internal/app/server_test.go

@@ -0,0 +1,29 @@
+package app
+
+import (
+	"net/http"
+	"net/http/httptest"
+	"testing"
+	"time"
+)
+
+func TestWithRequestTimeoutAddsContextDeadline(t *testing.T) {
+	handler := withRequestTimeout(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		deadline, ok := r.Context().Deadline()
+		if !ok {
+			t.Fatal("request context should have deadline")
+		}
+		if time.Until(deadline) > 250*time.Millisecond {
+			t.Fatalf("deadline too far away: %s", time.Until(deadline))
+		}
+		w.WriteHeader(http.StatusNoContent)
+	}), 200*time.Millisecond)
+
+	rec := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodGet, "/api/ops/health", nil)
+	handler.ServeHTTP(rec, req)
+
+	if rec.Code != http.StatusNoContent {
+		t.Fatalf("status = %d", rec.Code)
+	}
+}