问题排查指南用于帮助管理员、运营人员及技术人员在 Finger Manager 出现异常时，快速判断问题类型并找到对应的排查入口。
当系统出现登录失败、API 调用异常、订单错误、通知发送失败或其他系统问题时，可以按照本指南逐步进行检查。
管理员、运营团队、客服团队、技术团队、风控团队及系统集成团队
用于帮助管理员、运营人员及技术人员在 Finger Manager 出现异常时，快速判断问题类型并找到对应的排查入口。
通过 Finger Manager 配置的通知，将在 Finger Trader App 中按设定规则精准触达用户，提升运营效率与用户体验。
建议按照以下顺序进行排查：确认问题发生时间，确认发生问题的用户、账户或系统，确认问题所属模块，查看对应日志，查看 Error Code / Error Message，检查权限及系统配置，检查外部服务或第三方系统，根据 Request ID、Order ID 等继续追踪。
尽量保留准确的时间、用户、订单编号、Request ID 及错误信息，可以显著提高问题定位效率。
如果用户无法登录 Finger Manager，建议检查账号是否正确、密码是否正确、用户账户是否启用、是否拥有对应组织访问权限、IP 是否在白名单中、MFA 是否验证成功、SSO 是否正常、Session 是否已失效，以及是否存在连续登录失败限制。
建议查看登录日志。登录日志可以确认登录时间、来源 IP、设备及具体失败原因。
如果用户可以登录，但无法看到某个页面或执行某项操作，建议检查用户所属组织、用户角色、功能权限、数据权限、API 权限、是否拥有对应模块权限，以及当前功能是否已经启用。
例如用户可以进入客户管理页面，但无法修改客户资料，则应检查该角色是否拥有对应的 Edit / Update 权限。
如果 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、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 提交订单后返回 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、数据服务、通知服务和第三方系统。
因此，在排查复杂问题时，应结合相关日志、外部系统返回信息及机构自身技术架构进行综合判断。
Finger Manager 的问题排查应先从准确标识开始，再进入对应日志来源。
通过结合登录日志、操作日志、API 日志、通知发送记录、订单错误记录、权限、配置及外部服务状态，机构可以用更清晰的证据链定位大多数问题。
先记录问题发生时间、用户、Organization、模块、Request ID、Order ID、Error Code、Error Message、来源 IP、页面截图和复现步骤。
准确标识可以减少猜测，让跨日志排查更快。登录问题看登录日志；后台操作问题看操作日志；API 失败看 API 日志；通知失败看通知发送记录；订单问题看订单错误记录。
团队可以直接查对应证据来源，不需要先在所有模块里找。如果日志显示权限拒绝、IP 限制、服务商错误、超时或外部拒绝，再继续检查角色、数据权限、API 凭证、IP 白名单、SMTP、短信服务商、APNs、FCM、FIX Session、Broker、LP 或 OMS 状态。
Finger Manager 可以帮助区分内部配置问题和外部服务 / 集成问题。