task-166: HTTP 客户端契约表盘点（45 项超时/重试配置、198 个调用点扫描器 + 8 条测试 + 报告快照，不改生产代码）

2026-09-02 07:43:27 +08:00
parent bde9e75eed
commit f2736729fa
3 changed files with 1476 additions and 0 deletions
@@ -0,0 +1,93 @@
+"""task-166 HTTP 客户端契约盘点测试。
+
+对应 plan 10 任务 166 的 8 条用例：
+1. test_contract_table_all_clients  全客户端覆盖
+2. test_timeouts_listed             超时现状
+3. test_retry_listed                重试现状
+4. test_idempotency_listed          幂等性标注
+5. test_jdk_limits_noted            平台限制
+6. test_doc_committed               文档存在
+7. test_no_code_change              零代码变更
+8. test_repeatable                  可复查
+"""
+
+from __future__ import annotations
+
+import json
+import subprocess
+import unittest
+
+from http_client_audit import (
+    REPO_ROOT,
+    extract_client_sites,
+    extract_timeout_configs,
+    scan,
+)
+
+DOC_PATH = REPO_ROOT / "docs" / "http-client-contract-audit.md"
+
+
+class HttpClientAuditTest(unittest.TestCase):
+    def test_contract_table_all_clients(self):
+        configs = extract_timeout_configs()
+        self.assertGreaterEqual(len(configs), 4, "超时/重试配置字段必须齐全")
+        classes = {c["config_class"] for c in configs}
+        self.assertTrue(
+            any("Transient" in name or "Storage" in name for name in classes),
+            "存储客户端配置存在",
+        )
+        self.assertTrue(
+            any("SimilarAsin" in name or "ImageVideo" in name for name in classes),
+            "LLM/图片客户端配置存在",
+        )
+
+    def test_timeouts_listed(self):
+        fields = {c["field"] for c in extract_timeout_configs()}
+        self.assertTrue(any("connectTimeout" in f for f in fields), "connect 超时缺失")
+        self.assertTrue(any("readTimeout" in f for f in fields), "read 超时缺失")
+        self.assertTrue(any("writeTimeout" in f for f in fields), "write 超时缺失")
+        self.assertTrue(any("callTimeout" in f for f in fields), "call 超时缺失")
+
+    def test_retry_listed(self):
+        fields = {c["field"] for c in extract_timeout_configs()}
+        self.assertTrue(any("Retry" in f for f in fields), "重试配置缺失")
+
+    def test_idempotency_listed(self):
+        sites = extract_client_sites()
+        self.assertGreater(len(sites), 0, "客户端配置调用点必须记录")
+
+    def test_jdk_limits_noted(self):
+        sites = extract_client_sites()
+        self.assertTrue(
+            any(
+                "HttpClient" in s["snippet"] or "newBuilder" in s["snippet"]
+                for s in sites
+            ),
+            "JDK HttpClient 使用点必须记录",
+        )
+
+    def test_doc_committed(self):
+        self.assertTrue(DOC_PATH.is_file(), f"契约表文档缺失: {DOC_PATH}")
+        text = DOC_PATH.read_text(encoding="utf-8")
+        self.assertIn("超时", text)
+        self.assertIn("重试", text)
+        self.assertIn("幂等", text)
+
+    def test_no_code_change(self):
+        changed = subprocess.run(
+            ["git", "diff", "--name-only", "HEAD", "--", "backend-java/src"],
+            cwd=REPO_ROOT,
+            capture_output=True,
+            text=True,
+            check=True,
+        ).stdout.strip()
+        self.assertEqual(changed, "", f"生产代码被改动: {changed}")
+
+    def test_repeatable(self):
+        first = json.dumps(scan().to_dict(), sort_keys=True)
+        second = json.dumps(scan().to_dict(), sort_keys=True)
+        self.assertEqual(first, second, "盘点可复查")
+
+
+if __name__ == "__main__":
+    unittest.main()