如何通过Google Cloud Console创建Cloud Firestore触发的Cloud Function生成唯一随机数

嘿，作为经常和Firestore、Cloud Functions打交道的开发者，我来一步步带你实现这个需求——当Firestore的users集合新增文档时，自动生成唯一随机数并存入该文档。

步骤1：进入Google Cloud Console的Cloud Functions页面 #

打开Google Cloud Console，搜索并进入「Cloud Functions」服务（或者直接从左侧菜单找到它）。确保你已经选中了正确的项目，并且该项目已经启用了Firestore和Cloud Functions API（如果没启用，控制台会提示你开启，跟着引导走就行）。

步骤2：创建新的Cloud Function #

点击页面顶部的「创建函数」按钮，进入配置页面：

• 函数名称：填个好记的，比如generateUserRandomNumber
• 触发器类型：选择「Cloud Firestore」
• 事件类型：选择「创建文档时」
• 文档路径：填写你的用户集合路径，比如users/{userId}——这里的{userId}是通配符，匹配users集合下的任意新增文档
• 其他基础配置（比如区域）保持默认即可，或者根据你的需求调整

步骤3：编写函数代码 #

切换到「代码」标签页，默认是Node.js环境，我们直接用它来写逻辑：

先配置依赖（可选但推荐） #

如果需要生成严格唯一的ID（比如UUID），先在package.json的dependencies里添加：

"firebase-admin": "^11.11.0",
"firebase-functions": "^4.5.0",
"uuid": "^9.0.0"

（如果只是用简单随机数，前两个依赖默认已经有了，不用加uuid）

编写函数逻辑 #

替换index.js里的默认代码为：

const functions = require('firebase-functions');
const admin = require('firebase-admin');
// 如果用UUID的话，解开下面这行注释
// const { v4: uuidv4 } = require('uuid');

admin.initializeApp();

exports.generateUserRandomNumber = functions.firestore
  .document('users/{userId}')
  .onCreate(async (snap, context) => {
    // 方案1：生成1000-9999之间的随机整数（简单场景）
    const randomNumber = Math.floor(Math.random() * 9000) + 1000;
    
    // 方案2：生成UUID（严格唯一，推荐用于需要绝对不重复的场景）
    // const randomNumber = uuidv4();

    // 将随机数写入新增的用户文档
    await snap.ref.update({ uniqueRandomNumber: randomNumber });

    // 返回null表示函数执行完成
    return null;
  });

代码说明 #

• snap是新增文档的快照，snap.ref就是这个文档的引用，调用update就能把随机数加进去
• 如果用UUID，生成的是字符串格式的唯一ID，比简单随机数更可靠，不会有重复风险
• 用async/await确保更新操作完成后再结束函数

步骤4：部署函数 #

配置完代码后，滑到页面底部点击「部署」按钮，等待几分钟，控制台会显示部署进度。部署完成后，你可以在Cloud Functions列表里看到这个函数。

测试一下 #

现在去你的Firestore控制台，在users集合里新增一个文档（随便填点字段），等个几秒钟，刷新文档就能看到uniqueRandomNumber字段已经被自动添加进去啦！

注意事项 #

• 如果你的随机数需要全局唯一（比如不能和其他用户的重复），简单的Math.random可能会有极小的重复概率，这时候推荐用UUID，或者加一个查询逻辑：生成随机数后先检查Firestore里是否存在这个数，不存在再写入（不过会增加函数复杂度，需要处理并发）
• 确保Cloud Functions的服务账号有Firestore的读写权限，默认情况下控制台会自动配置，但如果遇到权限错误，可以去IAM页面检查「Cloud Functions 服务代理」的权限

内容的提问来源于stack exchange，提问作者DareDevil