数据可视化开发短记部署前核对什么图表使用 Worker、Wasm 或流式接口时部署问题通常出在资源路径、响应头和代理行为。上线前应在接近目标环境的地址上检查而不是假定开发环境的配置会自动生效。检查 Worker 与 Wasm 资源先确认浏览器实际请求的 URL、状态码、Content-Type和跨域策略。若应用需要SharedArrayBuffer再评估是否满足 COOP/COEP 的隔离要求这不是普通 Worker 的通用前提。curl -I https://cdn.example.com/assets/chart-worker.js \ -H Origin: https://dashboard.example.com同源部署最简单。必须跨域时优先使用明确的允许来源与版本化静态资源地址并在目标浏览器中验证 Worker 的创建和 Wasm 的加载。不要把 Blob 包装当作绕过 CSP 或跨域限制的通用方案。为流式接口单独验证代理SSE 或其他长连接接口需要确认代理是否缓冲响应、超时是否足够、断开后客户端如何处理。配置应只作用于对应路径并由实际流式测试验证。location /api/v1/predict/stream { proxy_pass http://ai_inference_backend; proxy_buffering off; proxy_cache off; proxy_read_timeout 300s; }修改前先执行nginx -t并通过灰度或预发环境确认变更范围。关闭缓冲可能影响连接数和资源消耗不能不加评估地应用到全部接口。管理运行时配置同一镜像可以读取运行时配置但公开到浏览器的值只能是公开地址和开关不能包含凭证。配置缺失时应给出可诊断的错误而不是静默回退。script window.__VISUAL_CONFIG__ { INFERENCE_GATEWAY: $INFERENCE_GATEWAY_URL, ENABLE_WASM: $ENABLE_WASM }; /script上线清单在目标域名验证 JS、Worker、Wasm、模型文件的状态码和 MIME 类型。验证 CSP、CORS 与缓存头是否符合当前功能。用代表性数据检查图表加载、流式更新和失败提示。记录本次环境的时延、错误和资源占用作为后续变更的比较基线。