From dcbcbc51eff8a51ed3c0bc4b103a0ede6ef77505 Mon Sep 17 00:00:00 2001
From: chiguyong <chiguyong@beyondsoft.com>
Date: Sun, 22 Mar 2026 01:58:07 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0known-patterns.json?=
 =?UTF-8?q?=20-=20=E6=B7=BB=E5=8A=A0API=E8=B7=AF=E5=BE=84=E5=8F=8C?=
 =?UTF-8?q?=E9=87=8D/api=E9=97=AE=E9=A2=98=E6=A8=A1=E5=BC=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增 pat-003: API路径双重/api前缀问题
- baseURL和API路径都包含/api导致请求变成/api/api/xxx
- 质量规则：baseURL不含/api，API路径使用/api/xxx
---
 05-ISSUES/known-patterns.json | 25 ++++++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/05-ISSUES/known-patterns.json b/05-ISSUES/known-patterns.json
index adb1366..19dfa8b 100644
--- a/05-ISSUES/known-patterns.json
+++ b/05-ISSUES/known-patterns.json
@@ -33,6 +33,22 @@
       ]
     },
     "pat-003": {
+      "name": "API路径双重/api前缀问题",
+      "source": "implementation_review",
+      "confidence": 0.95,
+      "applications": 2,
+      "created": "2026-03-22",
+      "category": "frontend",
+      "pattern": "baseURL和API路径都包含/api，导致请求变成/api/api/xxx",
+      "problem": "后端收到/api/api/permissions请求，返回NoResourceFoundException",
+      "solution": "baseURL设置为http://localhost:8080（不含/api），API路径使用/api/permissions",
+      "quality_rules": [
+        "baseURL: http://localhost:8080",
+        "API路径: /api/permissions, /api/users 等",
+        "不要在baseURL和API路径中同时包含/api"
+      ]
+    },
+    "pat-004": {
       "name": "CORS配置端口限制",
       "source": "implementation_review",
       "confidence": 0.85,
@@ -43,11 +59,10 @@
       "problem": "前端使用不同端口时API请求被CORS阻止",
       "solution": "CORS配置中添加所有可能的前端开发端口（5173-5180）",
       "quality_rules": [
-        "后端CorsConfiguration设置allowedOrigins包含所有开发端口",
-        "前端request.ts的baseURL使用绝对路径http://localhost:8080/api"
+        "后端CorsConfiguration设置allowedOrigins包含所有开发端口"
       ]
     },
-    "pat-004": {
+    "pat-005": {
       "name": "Git提交纪律",
       "source": "user_feedback",
       "confidence": 0.95,
@@ -63,7 +78,7 @@
         "在git commit之前不要进行npm install等可能重置环境的操作"
       ]
     },
-    "pat-005": {
+    "pat-006": {
       "name": "登录跳转使用window.location.href",
       "source": "implementation_review",
       "confidence": 0.90,
@@ -78,7 +93,7 @@
         "登出时也使用window.location.href = '/login'"
       ]
     },
-    "pat-006": {
+    "pat-007": {
       "name": "dist构建产物未及时更新",
       "source": "user_feedback",
       "confidence": 0.80,