From 52991dcfd53fa0a85600dba881c3a0e5c6d37a9e Mon Sep 17 00:00:00 2001
From: Milky0217 <m943790568@163.com>
Date: Sun, 19 Apr 2026 00:38:13 +0800
Subject: [PATCH] =?UTF-8?q?fix(api):=20=E4=BC=98=E5=8C=96=20/health=20?=
 =?UTF-8?q?=E7=AB=AF=E7=82=B9=E9=94=99=E8=AF=AF=E6=8F=90=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/handlers/health.rs | 63 ++++++++++++++++++++++++++++++++++--------
 1 file changed, 52 insertions(+), 11 deletions(-)

diff --git a/src/handlers/health.rs b/src/handlers/health.rs
index 1914af3..52ba9ef 100644
--- a/src/handlers/health.rs
+++ b/src/handlers/health.rs
@@ -1,21 +1,62 @@
 use actix_web::{web, get, HttpResponse, Responder};
 use sqlx::postgres::PgPool;
+use serde::Serialize;
+
+#[derive(Serialize)]
+pub struct HealthResponse {
+    pub status: String,
+    pub database: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub error: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub hint: Option<String>,
+}
 
 #[get("/health")]
 pub async fn health_check(pool: web::Data<PgPool>) -> impl Responder {
-    // 检查数据库连接
     match sqlx::query("SELECT 1").fetch_one(pool.get_ref()).await {
-        Ok(_) => HttpResponse::Ok().json(serde_json::json!({
-            "status": "healthy",
-            "database": "connected"
-        })),
+        Ok(_) => {
+            HttpResponse::Ok().json(HealthResponse {
+                status: "ok".to_string(),
+                database: "connected".to_string(),
+                error: None,
+                hint: None,
+            })
+        }
         Err(e) => {
-            tracing::error!("健康检查失败: {}", e);
-            HttpResponse::ServiceUnavailable().json(serde_json::json!({
-                "status": "unhealthy",
-                "database": "disconnected",
-                "error": "数据库连接失败"
-            }))
+            let err_str = e.to_string();
+            let (error_msg, hint_msg) = if err_str.contains("connection refused") {
+                (
+                    "无法连接到数据库".to_string(),
+                    "请检查数据库服务是否运行".to_string(),
+                )
+            } else if err_str.contains("Connection timed out") {
+                (
+                    "数据库连接超时".to_string(),
+                    "请检查网络连接".to_string(),
+                )
+            } else if err_str.contains("does not exist") {
+                ("数据库不存在".to_string(), "请检查数据库配置".to_string())
+            } else if err_str.contains("28P01") {
+                (
+                    "数据库认证失败".to_string(),
+                    "用户名或密码错误".to_string(),
+                )
+            } else {
+                (
+                    "数据库连接失败".to_string(),
+                    "请查看服务器日志获取详细信息".to_string(),
+                )
+            };
+
+            tracing::error!("健康检查失败: {:?}", e);
+
+            HttpResponse::ServiceUnavailable().json(HealthResponse {
+                status: "error".to_string(),
+                database: "disconnected".to_string(),
+                error: Some(error_msg),
+                hint: Some(hint_msg),
+            })
         }
     }
 }