| 图表区域空白 | library_path 必须指向可提供 TradingView 静态文件的路径；容器必须在 new widget(...) 之前已挂载。 |
chartWidget 一直为 null | 在创建 widget 后调用 setChartWidget（若集成要求，则在 onChartReady 内调用）。 |
| 扫描失败 / 401 | 确认用户已通过结果 iframe 登录，使 localStorage 中存在 iccandle_token。 |
| 缺少 Date Range 工具 | 在 drawings_access 中启用（见 开始使用）。 |
| 回放 K 线不出现 | 用 withPlayChart 包装 datafeed，并注册 getCustomIndicators（两者都必需）。指标主题须与图表一致。见 withPlayChart / getCustomIndicators。 |
| 扫描器操作被禁用 | 结果 iframe 加载完成后传 iframeLoaded={true}，或不做门控则省略该 prop。 |
| 主题显示异常 | 传入明确的 theme（light / dark）而非 system，并使 getCustomIndicators(theme) 与图表主题一致。 |
| 结果 iframe 空白 / CORS | 确认宿主可加载 https://embed-iccandle-app.iccandle.ai；检查控制台是否有被拦截的 frame 或 CSP frame-src 规则。 |
| 形态追踪不可用 | 用户必须已登录（存在 iccandle_token）。登录后从扫描器弹窗打开追踪。 |