跳到主要内容

前后端 URL 访问错误问题

一、适用场景

当部署或开发过程中遇到 URL 访问异常 或 前后端交互展示问题 时,可通过以下方式动态配置服务监听地址或生成完整 API URL,确保能够正常访问。

二、配置方案

方案 1:基础监听配置(通用)

如果在部署过程中发现URL问题或者前后端交互展示问题,可将服务绑定到 0.0.0.0 并指定端口(${PORT} 需替换为实际端口号):

  • 格式0.0.0.0:${PORT}
  • 示例(端口 9000)0.0.0.0:9000

方案 2:动态 URL 生成(CloudStudio 专属)

在开发环境中,可通过预置环境变量自动拼接完整 API URL,格式如下:

https://${X_IDE_SPACE_KEY}--${PORT}.${X_IDE_SPACE_REGION}.${X_IDE_SPACE_HOST}

参数说明:

变量名来源/用途示例值
${X_IDE_SPACE_KEY}CloudStudio 工作空间的唯一标识符(由平台自动分配)5adb8439bf8147658b86f063097fa479
${PORT}当前服务运行的端口号(需根据实际项目配置填写,如 90009000
${X_IDE_SPACE_REGION}云环境所在区域(如上海二区)ap-shanghai2
${X_IDE_SPACE_HOST}CloudStudio 平台的主机域名cloudstudio.club

生成示例(端口 9000):

https://5adb8439bf8147658b86f063097fa479--9000.ap-shanghai2.cloudstudio.club

三、配置示例

项目中创建一个 apiConfig.js 文件

这些变量被用来构建 API_BASE_URL ,然后在整个应用中使用