URL 访问异常排查
问题
当你遇到服务启动了但页面打不开、或前后端请求 URL 不通，通常按下面两步就能解决。
一、先确认：服务监听地址是否正确
很多服务默认只监听 127.0.0.1，会导致外部（预览/浏览器）访问不到。
- 建议：让服务监听
0.0.0.0并指定端口。
0.0.0.0:${PORT}
- 示例（端口 9000）：
0.0.0.0:9000
提示
不同框架的写法不同，但目标一致：host 绑定到 0.0.0.0，并明确端口。
二、在 CloudStudio 里生成可访问的预览 URL
在 CloudStudio 环境中，可以用预置环境变量拼出完整访问地址：
https://${X_IDE_SPACE_KEY}--${PORT}.${X_IDE_SPACE_REGION}.${X_IDE_SPACE_HOST}
变量说明
| 变量 | 含义 | 示例 |
|---|---|---|
${X_IDE_SPACE_KEY} | 工作空间唯一标识 | 5adb8439bf8147658b86f063097fa479 |
${PORT} | 服务端口号（由你的服务决定） | 9000 |
${X_IDE_SPACE_REGION} | 工作空间所在区域 | ap-shanghai2 |
${X_IDE_SPACE_HOST} | 平台域名 | cloudstudio.club |
生成示例（端口 9000）
https://5adb8439bf8147658b86f063097fa479--9000.ap-shanghai2.cloudstudio.club
常见误区
预览 URL 里的端口必须与服务实际监听端口一致，否则会访问失败。
三、最小配置示例（前端调用后端）
你可以把上面的 URL 作为 API_BASE_URL，统一在项目里使用。
