payment-platform/backend/tests/test_main.py

"""
后端接口测试入口。

注意：测试函数使用同步 `def`，由 TestClient 驱动；勿对用例本身使用 `async def`。
执行示例: `pytest tests/test_main.py` 或 `pytest tests/`
"""

import pytest
from fastapi.testclient import TestClient


def test_check_readiness(test_client: TestClient) -> None:
    """
    校验 ``/common/health/ready/``：数据库与 Redis（若启用）均可达时返回 200 与 checks 结构。
    """
    response = test_client.get("/common/health/ready/")
    assert response.status_code == 200
    body = response.json()
    assert body["success"] is True
    assert body["data"] is not None
    assert "checks" in body["data"]
    assert body["data"]["checks"].get("database") is True


def test_check_health(test_client: TestClient) -> None:
    """
    校验 `/common/health/` 返回统一成功响应结构。

    参数:
    - test_client (TestClient): pytest 注入的客户端。

    返回:
    - None
    """
    response = test_client.get("/common/health/")
    assert response.status_code == 200
    body = response.json()
    assert body["success"] is True
    assert body["code"] == 0
    assert body["msg"] == "系统健康"
    assert body["data"] is True
    assert body["status_code"] == 200


# 运行所有测试
if __name__ == "__main__":
    pytest.main(["-v", "tests/test_main.py"])