uniapp云函数报错：服务空间不在白名单中该如何解决？

在使用uniapp云函数时遇到报错提示“服务空间不在白名单中”，请问该如何解决？我的云函数之前在测试环境运行正常，但部署到正式环境后出现这个错误。已经检查过服务空间配置和权限设置，但问题仍然存在。是否有特定的白名单需要配置？还是需要在DCloud后台进行额外操作？求具体解决步骤或官方文档指引。

2 回复

在uniCloud控制台添加当前IP到白名单，或设置为0.0.0.0/0允许所有IP访问。


这个错误通常是因为你的云函数请求了外部网络资源，但你的uniCloud服务空间没有配置外网访问白名单。以下是解决方案：

方法一：配置域名白名单（推荐）

  1. 登录 uniCloud控制台
  2. 进入你的服务空间
  3. 找到「云函数/云对象」-「外网访问配置」
  4. 在「域名白名单」中添加需要访问的域名
    • 格式：*.example.com 或 api.example.com
    • 多个域名用英文逗号分隔

方法二：使用uniCloud内置服务（无需配置白名单）

  • 使用uniCloud.httpclient（内置网络请求）
// 云函数代码示例
const res = await uniCloud.httpclient.request('https://api.example.com/data', {
  method: 'GET',
  dataType: 'json'
})

方法三：使用云函数URL化（固定域名访问）

  1. 在云函数配置中开启「URL化」
  2. 通过生成的固定URL访问，不受白名单限制

检查要点：

  1. 确认请求的域名已正确添加到白名单
  2. 白名单配置后需要等待1-2分钟生效
  3. 免费版服务空间有域名数量限制（通常5个）

建议优先使用方法二，既安全又无需额外配置。如果必须访问外部API，请确保域名已正确添加到白名单中。

回到顶部