From 77dbfc1946d599f06a69afc204297dbe198a0cff Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Tue, 25 Aug 2026 15:00:02 +0800
Subject: [PATCH] docs: document Portal YAML runtime settings (#56)

---
 Troubleshooting.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Troubleshooting.md b/Troubleshooting.md
index d05e38b..ca299bc 100644
--- a/Troubleshooting.md
+++ b/Troubleshooting.md
@@ -61,6 +61,8 @@ LIMIT 10;
 5. 环境代理是否绕开安全 Dial；
 6. 上游返回的结果 URL 是否复用相同客户端。
 
+若 attempt latency 精确接近 Provider HTTP timeout，先检查 `portal/config/settings.yml` 的 `provider.http_timeout_seconds`；同时保证 `worker.lease_seconds` 比它大 5 秒以上。修改后必须重启 Portal，页面中的 ProviderModel timeout 不能突破更短的全局 HTTP timeout。
+
 拦截私网是正确行为，不能为联调关闭。需要访问内部 mock 时把 mock 与测试进程放在专用测试网络，并使用测试专用注入点，不在生产配置放行私网。
 
 ### 6. 文件和权限