a620906209/CFDivePlatform
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(swagger): 修正 VPS 無法顯示 Swagger UI 的問題 #53

Merged
a620906209 merged 1 commits from feat/swagger-coverage-gaps into master 2026-06-23 07:27:33 +00:00
Conversation 0 Commits 1 Files Changed 3
+13 -2
a620906209 commented 2026-06-23 07:27:26 +00:00
Owner
Copy Link
Copy Source

問題根因：

  1. deploy.yml 未執行 l5-swagger:generate，VPS 上不存在 api-docs.json
  2. @OA\Server 使用相對路徑 "/api"，Swagger UI Try it out 無法正確打到 VPS API

修正：

  • @OA\Server 改用 L5_SWAGGER_CONST_HOST 常數，透過 .env 各環境設定
  • deploy.yml 在 config:cache 後補上 l5-swagger:generate 步驟
  • .env.example 補上 L5_SWAGGER_CONST_HOST 與 L5_SWAGGER_GENERATE_ALWAYS 說明

VPS .env 需手動加入：
L5_SWAGGER_CONST_HOST=https://api.hank-space.com/api

Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com

問題根因： 1. deploy.yml 未執行 l5-swagger:generate，VPS 上不存在 api-docs.json 2. @OA\Server 使用相對路徑 "/api"，Swagger UI Try it out 無法正確打到 VPS API 修正： - @OA\Server 改用 L5_SWAGGER_CONST_HOST 常數，透過 .env 各環境設定 - deploy.yml 在 config:cache 後補上 l5-swagger:generate 步驟 - .env.example 補上 L5_SWAGGER_CONST_HOST 與 L5_SWAGGER_GENERATE_ALWAYS 說明 VPS .env 需手動加入： L5_SWAGGER_CONST_HOST=https://api.hank-space.com/api Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
a620906209 added 1 commit 2026-06-23 07:27:28 +00:00
fix(swagger): 修正 VPS 無法顯示 Swagger UI 的問題
Run Tests / test (pull_request) Successful in 33s
Details
b218fa0964 
問題根因：
1. deploy.yml 未執行 l5-swagger:generate，VPS 上不存在 api-docs.json
2. @OA\Server 使用相對路徑 "/api"，Swagger UI Try it out 無法正確打到 VPS API

修正：
- @OA\Server 改用 L5_SWAGGER_CONST_HOST 常數，透過 .env 各環境設定
- deploy.yml 在 config:cache 後補上 l5-swagger:generate 步驟
- .env.example 補上 L5_SWAGGER_CONST_HOST 與 L5_SWAGGER_GENERATE_ALWAYS 說明

VPS .env 需手動加入：
L5_SWAGGER_CONST_HOST=https://api.hank-space.com/api

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
a620906209 merged commit 9222bf17fc into master 2026-06-23 07:27:33 +00:00
a620906209 deleted branch feat/swagger-coverage-gaps 2026-06-23 07:27:33 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
a620906209
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: a620906209/CFDivePlatform#53
Delete Branch "feat/swagger-coverage-gaps"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?