URL 访问异常排查

最近更新时间:2026-05-19 18:07:22

我的收藏
问题
当您遇到服务启动了但页面打不开、或前后端请求 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,统一在项目里使用。