| 图表区域空白 | library_path 必须指向可提供 TradingView 静态文件的路径；容器必须在 new widget(...) 之前已挂载。 |
chartWidget 一直为 null | 创建 widget 后设置 chartWidget（若集成要求，则在 onChartReady 内设置）。TradingView 实例请使用 shallowRef。 |
| 扫描失败 / 401 | 确认用户已通过结果 iframe 登录，使 localStorage 中存在 iccandle_token。在 iframe 加载时调用 handleResultIframeLoad，以便在登录前发送 parent-origin。 |
| 绘图工具栏仍显示 Date Range | 在 drawings_access 中将其加入黑名单——扫描器负责管理 date_range 选择器（见 开始使用）。 |
| 回放 K 线不出现 | 用 withPlayChart 包装 datafeed，并注册 getCustomIndicators（两者都必需）。指标主题须与图表一致。见 withPlayChart / getCustomIndicators。 |
| 尚未揭示的预测 K 线显示为色块 | 将 chartMaskColors 设为与图表面板背景（paneProperties.background）完全一致。默认值（#ffffff / #0F0F0F）仅匹配 TradingView 默认面板。不要使用透明色。见 chartMaskColors。 |
| 扫描器操作被禁用 | 结果 iframe 加载完成后传 :iframe-loaded="true"，或不做门控则省略该 prop。 |
| 结果 iframe 从不更新 | 实现必需的 submitCallback，并用其收到的 URL 设置 iframe 的 src。 |
| 主题显示异常 | 传入明确的 theme（light / dark）而非 system，并使 getCustomIndicators(theme) 与图表主题一致。 |
| 结果 iframe 空白 / CORS | 确认宿主可加载 https://embed-iccandle-app.iccandle.ai；检查控制台是否有被拦截的 frame 或 CSP frame-src 规则。 |
| Stripe 返回 / 订阅状态过期 | 在 iframe @load 时调用 handleResultIframeLoad(iframe)，以便发送 parent-origin / payment-success。 |
| 定价弹窗打不开 | 传入指向结果 iframe 的 :result-iframe-ref（{ current } 盒子），以便组件发送 open-pricing。 |
| 形态追踪不可用 | 用户必须已登录（存在 iccandle_token）。登录后从扫描器弹窗打开追踪。 |
| 时间轴上没有新闻标记 | 可选：在你自己的 datafeed 上实现 getTimescaleMarks，并在 onReady 中设置 supports_timescale_marks: true。见 开始使用 → 步骤 6。 |