Skip to main content

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，统一在项目里使用。