【uniCloud 阿里云】uni-config-center 无法单独上传，云函数中读取到的 config 始终为空（config keys: []）

该问题请在专业群（ uniCloud 官方技术交流群 ） 咨询，群中有相关专业的管理员和群友。

✅ 问题根因总结

您遇到的“uni-config-center 无法单独上传，云函数读取配置为空”问题，根本原因是配置文件路径错误和未正确上传公共模块。在 uniCloud 阿里云环境中，uni-config-center 的配置文件必须放在以下路径：

uniCloud-aliyun/cloudfunctions/common/uni-config-center/<pluginId>/config.json

而您当前的路径：

uniCloud-aliyun/uni-config-center/config.json

这是无效路径，不会被上传，也不会被打包进云函数运行环境。

✅ 正确做法（一步步来）

✅ 1. 移动配置文件到正确路径

请将您的配置文件移动到：

uniCloud-aliyun/cloudfunctions/common/uni-config-center/telemetry/config.json

确保文件内容是标准 JSON，例如：

{  
  "telemetry": {  
    "ingestToken": "abc123"  
  }  
}

✅ 2. 上传 uni-config-center 公共模块

在 HBuilderX 中：

• 找到 uniCloud-aliyun/cloudfunctions/common/uni-config-center
• 右键 → 上传公共模块

⚠️ 注意：uni-config-center 是一个公共模块，必须单独上传，不能靠“上传云函数”时自动打包。

✅ 3. 云函数中添加依赖

在您的云函数（如 telemetry-write）上：

• 右键 → 管理公共模块依赖
• 勾选 uni-config-center

✅ 4. 云函数中读取配置

使用如下代码读取配置：

const createConfig = require('uni-config-center');  
const telemetryConfig = createConfig({ pluginId: 'telemetry' }).config();  
const ingestToken = telemetryConfig?.telemetry?.ingestToken;

❗常见误区提醒

✅ 推荐做法：设备 token 配置方式

对于“设备侧 token/secret 配置”，推荐使用 uni-config-center，不建议使用 process.env，因为：

• process.env 是全局变量，容易冲突
• uni-config-center 支持多环境、多插件隔离
• 支持热更新（重新上传即可）

✅ 总结一句话

uni-config-center 的配置文件必须放在 cloudfunctions/common/uni-config-center/<插件名>/config.json，并通过“上传公共模块”方式部署，才能被云函数读取到。

如仍有问题，建议提供：

• 当前 uni-config-center 的完整路径截图
• 云函数日志中是否出现 config.json not found 等字样

我可以帮您进一步定位。