Firebase Text To Speech扩展问题咨询：路径未回写及子集合配置

一、音频路径未写回原文档的排查与解决 #

• 检查扩展核心配置：确认安装扩展时是否正确设置了Field name for audio path（音频路径存储字段名），这个配置项是执行第三步的关键——未指定的话，扩展不知道要把路径写入哪个字段，自然不会执行写回操作。同时要确保Input text field name（待转换文本的字段名）和你写入文档的文本字段完全匹配，若文本字段不匹配，音频生成失败会直接导致后续步骤中断。
• 验证权限配置：扩展依赖的Cloud Function服务账号需要拥有Firestore文档的写入权限。在Firebase控制台的「IAM与管理员」中，找到该扩展对应的服务账号（命名通常包含text-to-speech），确认其拥有Cloud Datastore User或更具体的Firestore写入权限。
• 查看函数日志定位问题：进入Firebase控制台的「Cloud Functions」，找到扩展对应的函数（一般为ext-googlecloud-text-to-speech-generateAudio），查看执行日志。如果有报错（比如权限不足、字段不存在、音频生成失败），日志会明确给出原因，针对性修复即可。

二、配置根目录以外的嵌套集合路径 #

扩展的Collection path配置项支持Firestore的完整嵌套路径格式，直接填写对应路径即可：

• 比如要监听users集合下所有文档的子集合notes，路径填写为users/{userId}/notes，其中{userId}是通配符，代表users集合下的任意文档ID；
• 若要监听更深层级的集合，比如groups/{groupId}/posts/{postId}/comments，直接按此格式填写，扩展会自动监听该路径下的所有文档写入事件。

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