排查問題的基本思路

建議按照以下順序進行排查：確認問題發生時間，確認發生問題的用戶、帳戶或系統，確認問題所屬模組，查看對應日誌，查看 Error Code / Error Message，檢查權限及系統配置，檢查外部服務或第三方系統，根據 Request ID、Order ID 等繼續追蹤。

盡量保留準確的時間、用戶、訂單編號、Request ID 及錯誤資訊，可以顯著提高問題定位效率。

登入問題

如果用戶無法登入 Finger Manager，建議檢查帳號是否正確、密碼是否正確、用戶帳戶是否啟用、是否擁有對應組織訪問權限、IP 是否在白名單中、MFA 是否驗證成功、SSO 是否正常、Session 是否已失效，以及是否存在連續登入失敗限制。

建議查看登入日誌。登入日誌可以確認登入時間、來源 IP、設備及具體失敗原因。

權限問題

如果用戶可以登入，但無法看到某個頁面或執行某項操作，建議檢查用戶所屬組織、用戶角色、功能權限、數據權限、API 權限、是否擁有對應模組權限，以及當前功能是否已經啟用。

例如用戶可以進入客戶管理頁面，但無法修改客戶資料，則應檢查該角色是否擁有對應的 Edit / Update 權限。

API 調用失敗

如果 API 請求失敗，建議檢查 API Key 是否有效、API Secret 是否正確、請求簽名是否正確、API 權限是否開啟、IP 是否在 API 白名單中、Endpoint 是否正確、HTTP Method 是否正確、請求參數是否完整、請求格式是否正確、是否超過 Rate Limit，以及外部網路是否正常。

建議查看 API 日誌，重點關注 Request ID、HTTP Status、Error Code、Error Message、Source IP 和 Response Time。

通知發送失敗

如果 Push、Email、SMS 或其他通知發送失敗，建議檢查通知對象是否正確、用戶聯絡方式是否有效、Device Token 是否有效、Apple APNs 配置是否正常、Google FCM 配置是否正常、SMTP 配置是否正確、短信服務商帳戶是否正常、API Key 或服務商憑證是否有效、第三方服務是否出現異常，以及消息內容是否符合服務商要求。

建議查看通知發送記錄，重點確認 Channel、Provider、Message ID、Status、Error Code 和 Error Message。

訂單異常

如果訂單提交失敗、被拒絕或沒有正常返回狀態，建議按照訂單處理流程逐步檢查：用戶提交訂單、參數校驗、風控檢查、訂單路由、Broker / LP / OMS、執行系統、訂單回報。

建議檢查 Ticker 是否正確、產品是否允許交易、當前市場是否開放、訂單類型是否支援、數量是否符合要求、價格精度是否正確、帳戶狀態是否正常、購買力是否充足、風控是否拒絕、路由是否正常、Broker / LP 是否返回 Reject，以及 FIX Session 是否正常。

建議查看訂單錯誤記錄、API 日誌及相關交易日誌。

訂單狀態不同步

如果前端看到的訂單狀態與外部 Broker 或交易系統不一致，建議檢查 Order ID、Client Order ID、FIX ClOrdID、ExecID、最近一次訂單回報時間、外部系統是否已返回 Execution Report、回報消息是否正常解析，以及是否存在網路延遲或超時。

如使用 FIX，可以結合對應 FIX Session 與 Execution Report 進行排查。

頁面數據異常

如果後台頁面數據顯示異常，例如數據沒有更新、統計數據不一致、頁面為空或部分用戶看不到數據，建議檢查當前時間範圍、數據權限、Organization ID、用戶角色、頁面篩選條件、數據來源、API 是否正常，以及是否存在快取或同步延遲。

如果只有部分用戶出現問題，優先檢查用戶角色與數據權限。

配置修改後沒有生效

如果修改系統配置後前端沒有變化，建議檢查配置是否保存成功、是否操作了正確的 Organization、當前用戶是否有修改權限、是否存在配置生效延遲、App 是否需要重新進入頁面、是否需要重新登入，以及外部系統是否快取舊配置。

同時可以查看操作日誌，確認修改是否已經被系統記錄。

IP 白名單問題

如果開啟 IP 白名單後無法訪問系統，建議檢查當前公網 IP 是否正確、是否使用動態 IP、VPN 是否改變出口 IP、公司網路是否有多個出口，以及 API 伺服器實際出口 IP 是否與配置一致。

建議先確認當前實際公網 IP，再與白名單配置進行比對。

系統錯誤

如果出現頁面無法載入、Internal Server Error、服務暫時不可用、數據處理失敗或系統任務失敗等系統內部異常，建議記錄問題發生時間、頁面或功能名稱、Organization ID、User ID、Request ID、Error Code 和 Error Message。

然後根據部署及支援流程查看對應的系統錯誤記錄或技術日誌。

如何使用日誌進行排查

Finger Manager 提供多種日誌，可以針對不同問題進行查詢：登入問題對應登入日誌，後台操作問題對應操作日誌，API 問題對應 API 日誌，通知問題對應通知發送記錄，訂單問題對應訂單錯誤記錄，系統異常對應系統錯誤記錄。

如果問題涉及多個系統，可以結合多個日誌進行交叉確認。

建議優先保留的資訊

當需要提交問題給內部技術團隊或 Finger Manager 支援團隊時，建議盡量提供問題發生時間、Organization ID、User ID、Account ID、Order ID、Client Order ID、Request ID、API Endpoint、Error Code、Error Message、來源 IP、頁面截圖和問題復現步驟。

請不要透過普通消息發送密碼、完整 API Secret、Access Token、私鑰或其他敏感認證資訊。

示例：API 訂單提交失敗

例如用戶透過 API 提交訂單後返回 HTTP 403。排查時可以打開 API 日誌，根據 Request ID 找到請求，查看 Error Code。如果系統顯示 IP_NOT_ALLOWED，則檢查來源 IP，對比 API IP 白名單，添加正確伺服器出口 IP 後重新發送請求。

透過這種方式，可以快速定位問題原因。

示例：訂單被拒絕

如果用戶提交訂單後返回 RISK_REJECTED，可以根據 Order ID 查詢訂單錯誤記錄，確認錯誤階段為 Risk Check，查看對應 Error Message，檢查帳戶風險限制，檢查訂單數量與購買力，調整問題後再重新提交。

無法確定問題來源

如果暫時無法判斷問題屬於哪個模組，可以優先記錄問題發生時間、User ID、Organization ID、頁面或操作名稱、Request ID / Order ID 和錯誤截圖。

然後依次檢查登入日誌、操作日誌、API 日誌、訂單錯誤記錄和系統錯誤記錄。透過時間和 ID 進行交叉查詢，通常可以逐步定位問題。

說明

問題排查指南用於幫助機構快速定位 Finger Manager 使用過程中的常見異常。

實際問題可能同時涉及 Finger Manager、Finger Trader、API、FIX、Broker、LP、數據服務、通知服務和第三方系統。

因此，在排查複雜問題時，應結合相關日誌、外部系統返回資訊及機構自身技術架構進行綜合判斷。