LangGraph Studio 故障排除指南¶
Safari与本地开发服务器连接错误¶
Safari阻止在localhost上使用纯HTTP流量。如果您使用vanilla langgraph dev启动Studio，页面可能会报告“加载助手失败”的错误，并且浏览器开发者工具将显示网络错误。
快速修复——通过安全的Cloudflare隧道运行Studio¶
命令将打印一个URL，如：
https://smith.langchain.com/studio/?baseUrl=https://hamilton-praise-heart-costumes.trycloudflare.com
其中
表示您的代理服务器暴露的端点。在Safari中打开该URL，Studio应该会立即加载。
替代方案——使用基于Chromium的浏览器¶
Chrome和其他基于Chromium的浏览器允许在localhost上使用HTTP，因此普通的langgraph dev应该可以正常工作而无需额外步骤。
如果仍然无法加载¶
- 确保studio URL中的
baseUrl查询参数指向的是**隧道URL**而不是localhost。 - 使用
langgraph --version确认您的CLI版本。
不需要其他配置、证书或CORS调整。
使用本地开发服务器时 Bravery 连接错误¶
默认情况下，如果启用了 Bravery 屏蔽功能，则 Bravery 会阻止 localhost 上的纯 HTTP 流量。如果您使用普通的 langgraph dev 命令启动 Studio，页面可能会报告“加载助手失败”的错误，并且浏览器开发者工具中也会显示网络错误。
快速修复 — 禁用 LangSmith 的 Bravery 屏蔽功能¶
点击地址栏旁边的 Bravery 图标，在弹出窗口中关闭 Bravery 屏蔽功能。
替代方案 — 通过安全的 Cloudflare 隧道运行 Studio¶
该命令会打印一个 URL，如：
https://smith.langchain.com/studio/?baseUrl=https://hamilton-praise-heart-costumes.trycloudflare.com
其中
表示您的代理服务器暴露的端点。在 Bravery 中打开此 URL，Studio 应该会立即加载。