Apidog Docs
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
Learning Center
HomeSupport CenterAPI ReferencesDownloadChangelog
Learning Center
HomeSupport CenterAPI ReferencesDownloadChangelog
  1. 自動化測試
  • Back to home
  • 支援中心
  • Apidog 支援中心
  • 匯入/匯出
    • 如何將 API 資料匯入 Apidog?
    • 如何在 Apidog 中匯入 cURL?
    • 如何將 Postman 環境遷移到 Apidog?
    • 如何在匯入 Swagger/OpenAPI 時自動分組端點?
  • 傳送請求
    • Apidog 支援 Socket.IO 嗎?
    • 為什麼參數值中的「+」會被解碼為空格?
    • 如何在 Apidog 中傳送請求?
    • 如何在 Apidog 中傳送 GraphQL 請求?
    • 如何在 Apidog 中傳送 gRPC 請求?
    • 如何在 Apidog 中傳送 SOAP/WebService 請求?
    • 如何在 Apidog 中傳送 WebSocket 請求?
    • Apidog 是否支援 WebSocket API 中的預先請求/測試腳本與斷言?
    • 如何在 Apidog 中傳送 SSE 請求?
    • 如何在資料夾層級新增預設標頭?
    • Apidog 是否支援 gRPC API 中的預請求/測試腳本與斷言?
    • ELANREFUSED.DNS 解析器錯誤
    • 為什麼我在傳送請求時會收到「socket hang up」錯誤?
    • 修復請求錯誤
      • 修正 read ECONNRESET 錯誤
      • 修正 ECONNREFUSED 錯誤
      • 修正 ETIMEDOUT 錯誤
      • 修復 ENOTFOUND: Couldn't resolve host 錯誤
      • 修正 ENOTFOUND: getaddrinfo ENOTFOUND www 錯誤
      • 修復 connect EHOSTUNREACH 錯誤
  • 設計 API
    • 如何在路徑中使用變數?
    • 我可以使用回應元件作為預設回應嗎?
    • 如何查看誰修改過端點?
    • 如何在 Apidog 中批次刪除端點資料夾?
    • 如何批次新增/移除端點路徑的前綴?
    • 如何在 Schema Editor 中移動屬性的層級?
    • 如果某個字串屬性有多個列舉值,並且會用於各種位置,如何在整個文件中一致地引用此 enum?
    • 如何取得 Apidog 資源資料夾 ID?
    • 如何取得 Apidog 的資源資料夾 ID?
    • 如何在 URL 路徑中使用變數?
    • 如果端點、文件或測試情境不小心被刪除了,我該怎麼辦?
    • Apidog 是否支援自訂端點的請求程式碼?
    • 將 Swagger/OpenAPI 匯入 Apidog 時,如何自動分組端點?
    • 如何在模擬回應中產生不重複的陣列資料?
    • 為什麼路徑不支援輸入「#」?
  • 偵錯 API
    • Apidog 如何與第三方金鑰管理系統整合?
    • 為什麼相同的請求在其他工具(例如 Postman)中可以正常運作,但在 Apidog 中卻不行?
    • 如何在 Apidog 中從資料庫取得變數值?
    • 如何將環境從其他工具遷移到 Apidog?
    • 如何在 Apidog 中使用腳本進行斷言?
    • JSONPath 只能擷取陣列。如何在 Apidog 中從陣列內擷取單一元素?
    • 當不同環境有不同的資料庫帳號憑證時,如何在 Apidog 中設定資料庫操作?
    • 如何在自訂腳本中取得服務基礎 URL?
    • 當 API 回應過大時,為什麼 Apidog 會回報超過 Node.js 字串長度上限的錯誤?
    • 控制台列印的大小限制是多少?為什麼列印大型檔案時會出現錯誤?
    • 如何解決 Windows 上的 DB2 資料庫連線錯誤?
    • 為什麼我在 Apidog 中連線到 Oracle 資料庫時會出現 NJS-045 錯誤?
    • 如何在 Apidog 自訂腳本中產生動態值?
    • 為什麼用戶端請求相同端點時成功,但在網頁端除錯時卻發生「無法請求地址」錯誤?
    • 為什麼當回應過大時 Apidog 會回報錯誤?
    • 如何使用 Apidog 錄製端點?
    • 定義端點回應時,是否允許端點沒有回應內容?
    • 如何在自訂腳本中取得服務 baseURL?
    • 如何在 Apidog 中查看原始封包?
    • 為什麼我在發送請求時會看到「Invalid URI xxx」錯誤?
    • 如何在 Apidog 腳本中發出非同步請求?
    • 為什麼我在傳送請求時會看到「Couldn't resolve host」訊息?
    • 主控台列印大小限制是多少?為什麼列印大型檔案時會出現錯誤?
    • 如何在端點請求中上傳檔案?
    • 如果 Apidog 當機或未顯示回應資料該怎麼辦?
    • Apidog 用於 OAuth2.0 的官方重新導向 URI
  • Mock API 資料
    • 如何自動模擬 API?
    • Apidog 模擬可以做什麼?
    • 如何在 Apidog 中模擬固定的 API 資料?
    • 如何在 Apidog 中模擬條件式資料?
    • 如何在 Apidog 中啟用雲端模擬?
    • 如何在 Apidog 中啟用自架模擬?
    • Apidog 支援模擬 WebSocket API 嗎?
    • 為什麼瀏覽器在請求模擬端點時沒有回傳內容?
  • 自動化測試
    • 為什麼測試情境在我的本機用戶端執行時沒有問題,但在 Apidog CLI 或 runner 中執行時會發生錯誤?
    • 如何在 Apidog 中建立測試情境?
    • 如何在測試步驟之間傳遞資料?
    • 為什麼我無法成功引用前置步驟資料?
    • 如何在 Apidog 中使用 foreach 迴圈?
    • 從端點/端點案例同步資料有什麼差異?
    • 如何在 Apidog 中使用測試資料?
    • 如何在 Apidog 的腳本中擷取測試資料?
    • 如何在 Apidog 中批次執行測試情境?
    • 如何在 Apidog 中排程測試任務?
    • 如何在 Apidog 中執行效能測試?
    • 如何在效能測試中查看實際的請求與回應?
    • 如何在 Apidog 中匯出效能測試報告?
    • 如何使用資料庫查詢結果作為循環 API 請求的參數?
    • 在 CI/CD 期間於 ApiDog 中擷取並驗證 Stripe Webhook
    • 如何解決「Error: unable to verify the first certificate on runner」錯誤?
    • General Runner Docker 容器「Not Found」錯誤。
    • 如何在 Apidog Web 版中設定 General Runner 的伺服器主機?
    • 為什麼排程測試情境最後顯示 0 個請求?
    • 如果在 Runner 或 CLI 中找不到檔案上傳參數,我該怎麼辦?
    • 如何使用 Runner 執行包含上傳檔案步驟的測試場景?
    • 如何解決「Error: unable to verify the first certificate on runner」錯誤?
    • 當 Runner 發生問題時,如何存取並搜尋 Runner 日誌以識別問題?
    • 如果端點參數是上傳檔案,且在 Runner 或 CLI 中找不到,該怎麼辦?
    • 為什麼當 API 使用案例變更時,測試步驟不會自動同步?
    • 為什麼在 Markdown 文件中使用多個美元符號會導致部分內容無法正確顯示?
    • 自架 Runner 執行任務後,是否會在伺服器上產生測試報告?
    • 我可以為測試情境中的請求新增統一的前置/後置處理器嗎?
    • 如何在單次自動化測試執行期間保持動態值一致?
  • 發布 API 文件
    • 如何在已發布的文件中隱藏所有 Apidog 標誌?
    • 當 API 規格更新時,API 文件會變更嗎?
    • 如何在 Apidog 中將 API 分享給協作者?
    • 如何自訂 Apidog 文件的網域?
    • 如何在 Apidog 中建立多版本文件?
    • Apidog 中 Publish Docs Sites 的分享範圍
    • Apidog 中 Share Doc 清單的分享範圍
    • 為什麼已發布的 Share Docs 沒有顯示 hostname?
    • 文件使用者如何在共享文件中修改 Base URL?
    • 我可以複製已發布的 Apidog 文件,以便在自己的專案中使用嗎?
    • 如何在 Apidog 線上文件中共用標頭(例如 Token)?
    • 為什麼我的團隊成員找不到已發布的文件?
    • 如何修復自訂網域上的 SSL 憑證過期或 Cloudflare 526 錯誤?
    • 自訂 SMTP 設定成功,但允許清單使用者未收到 OTP 電子郵件
  • Markdown
    • 如何使用卡片連結到 Apidog 內的各種頁面或端點?
    • 為什麼在 Markdown 文件中使用多個 $ 符號時,部分內容無法正確顯示?
    • 如何在 Apidog Markdown 中使用透明背景圖片?
    • 如何設定 Markdown 表格的欄寬?
    • 如何將內部 API、文件、資料結構描述或資料夾插入 Markdown 文件?
    • 如何在 Apidog 卡片元件中新增專案內文件或端點的連結?
  • 分支
    • 如何存取 sprint 分支?
  • 管理
    • 如何靜默安裝 Apidog 用戶端?
    • 為什麼我明明有管理員存取權,卻看到「No Permission」錯誤?
    • 如何查看 Runner 版本號?
    • Apidog 支援 win7 嗎?
    • 為什麼 Apidog 安裝後會顯示錯誤「Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll」?
    • 訂閱變更與退款
    • Web 請求可正常運作,但 App 出現「read ECONNRESET」——為什麼?
    • 為什麼 Windows 系統更新後我無法開啟 Apidog?
    • 為什麼 Apidog 在 Windows 系統更新後無法開啟
  • 帳單
    • 我可以在 Apidog 中為我的團隊設定獨立的帳務帳戶嗎?
    • Apidog 上的團隊存取與帳單問題
    • 受邀團隊成員無法存取 Apidog。
    • 將個人付費團隊轉移至組織
  • 私有化部署
    • Apidog 自託管(企業)版本中的使用者與存取管理
  • Web 與用戶端
    • 下載與安裝 Linux 桌面版
  1. 自動化測試

如何在 Apidog 中執行效能測試?

效能測試功能目前處於 Beta 階段。
效能測試會向 API 傳送大規模服務請求,以識別效能瓶頸、評估穩定性、揭露壓力下的潛在風險,並確保 API 能在高負載下可靠運作並回應請求。
效能測試

設定配置項目#

在執行效能測試之前,你需要指定測試場景的執行環境,並可選擇性地指定測試資料,以及配置效能測試設定。

執行環境#

測試場景中的執行環境會繼承自目前專案的環境。

測試資料#

關聯測試資料後,虛擬使用者將使用測試資料中定義的變數來執行請求。你可以選擇以「隨機匹配」或「順序匹配」模式執行:
隨機匹配: 每位虛擬使用者會從測試資料中隨機選取一列資料來執行。在此模式下,所有虛擬使用者都會選取一列測試資料並執行效能測試。
順序匹配: 每位虛擬使用者會依序從測試資料中選取一列資料。注意:如果虛擬使用者數量超過測試資料列數,超出的虛擬使用者將不會開始效能測試。
深入了解測試資料。

虛擬使用者(並行使用者)#

最多支援 100 位虛擬使用者。在指定的測試時間內,模擬線上使用者並行重複執行測試場景。

測試持續時間#

效能測試的總執行時間。在此期間,每位虛擬使用者都會持續循環執行測試場景中的所有 API。

漸增持續時間#

使用者通常會隨著時間逐步存取服務,而不是瞬間同時存取。為了模擬這種情況,請設定漸增時間,在前 X 分鐘內(X 為預設值)逐步增加並行使用者數量。如果 X 設為 0,所有虛擬使用者都會在測試開始時立即啟動。

執行效能測試#

觸發效能測試後,直覺式視覺化面板會顯示每個 API 的關鍵指標,例如 總請求數、平均吞吐量、平均回應時間、最大/最小回應時間和錯誤數。
效能測試視覺化
一個專案同一時間只能執行一個效能測試。如果需要執行優先順序更高的測試,請點選右上角的「終止」按鈕。

查看測試過程#

在效能測試期間,你可以將滑鼠懸停在測試圖表上,即時查看每個時間區段的測試詳細資料。
測試詳細資料
點選「錯誤」以檢查該 API 的失敗請求並分析可能原因。你也可以在篩選列中篩選 API 請求。
錯誤分析
由於效能測試中的 API 請求量很大,因此只會對失敗請求進行分類並以統計方式顯示。不會記錄每個 API 的詳細錯誤資訊和請求詳細資料。如果遇到非預期錯誤,請先執行「功能測試」並解決所有問題後,再執行「效能測試」。

查看測試報告#

點選 「測試報告」 分頁,即可查看目前測試場景的歷史測試報告。
測試報告

FAQ#

Q:如何匯出效能測試報告?
A:效能測試目前處於 Beta 階段,Apidog 尚不支援匯出效能測試報告。你只能在 Apidog 用戶端內查看結果。
Q:如何在效能測試中查看實際的請求和回應?
A:Apidog 的效能測試不提供查看實際請求和回應的能力。
這是因為效能測試著重於評估 API 在高負載下的行為,而這些 API 應該已經 100% 通過功能測試。任何問題都很可能是由伺服器效能造成,而不是請求/回應內容造成。
因此,查看實際請求和回應無助於排查效能相關問題。因此,Apidog 的效能測試功能不提供查看實際請求和回應的功能。
Modified at 2026-06-11 10:26:02
Previous
如何在 Apidog 中排程測試任務?
Next
如何在效能測試中查看實際的請求與回應?
Built with