Firebase Studio 问题排查和常见问题解答

提示：如果您找不到问题的答案，请联系 Firebase 支持团队，或在社区论坛发帖求助。

Firebase Studio一般问题

如何从 Firebase Studio 下载我的文件？

如需将文件打包为 zip 文件下载，请执行以下操作：

• 在“探索器”窗格中右键点击任意目录，然后选择压缩并下载。

如需下载项目目录中的全部内容，请执行以下操作：

1. 选择文件 > 打开文件夹。

2. 接受默认的 /home/user 目录。

3. 文件加载完成后，右键点击工作目录，然后选择压缩并下载。如果您使用 App Prototyping agent，工作目录将是 studio。如果使用模板或上传的项目，工作目录名称将是您的项目名称。

4. 当系统提示您重新构建环境时，点击取消。

5. 下载完成后，从文件菜单重新打开工作目录，以返回工作区。

提示：您还可以导出到 GitHub。

未启用第三方 Cookie。

开始前，您可能需要在浏览器中启用第三方 Cookie。Firebase Studio 需要第三方 Cookie 以在大多数浏览器中完成工作区身份验证。

Chrome

1. 打开设置。
2. 打开隐私与安全标签页。
3. 确保已启用允许所有 Cookie。
4. 打开 Firebase Studio。
5. 点击地址栏中的可见性图标 visibility_off，打开跟踪保护面板。开启第三方 Cookie 设置，以临时允许第三方 Cookie。此设置将在 Firebase Studio 上启用 Cookie，持续 90 天。

Safari

1. 打开 Safari > 设置…。
2. 关闭以下设置：
   • 高级 > 阻止所有 Cookie
   • 隐私设置 > 阻止跨网站跟踪
3. 打开 Firebase Studio。

Firefox

对于 Firefox，您无需启用第三方 Cookie。打开 Firebase Studio。

Opera

1. 打开 Opera。
2. 打开菜单并点击设置。
3. 前往隐私与安全部分，然后展开第三方 Cookie 选项。
4. 选择在无痕模式下阻止第三方 Cookie 或允许第三方 Cookie。
5. 打开 Firebase Studio。

弧形

1. 前往 arc://settings。
2. 前往隐私与安全部分，然后展开第三方 Cookie 选项。
3. 选择在无痕模式下阻止第三方 Cookie 或允许第三方 Cookie。
4. 打开 Firebase Studio。

Brave

对于 Brave，您无需启用第三方 Cookie。打开 Firebase Studio。

为什么 Firebase Studio 需要启用第三方 (3P) Cookie？

由于我们在一个网域 (studio.firebase.google.com) 中呈现来自另一个网域（cloudworkstations.dev 的子网域）的 iframe，因此 Firebase Studio 需要启用第三方 Cookie，以支持安全的跨源通信。

打开工作区时，系统会显示“无法将您的请求转发到后端。无法通过端口 80 连接到服务器。”消息。

请等待约 5 秒后刷新页面。

我的预览无法加载，但我在代码中无法发现任何问题。如何重启 Firebase Studio？

如果 Firebase Studio 无法正常刷新（通常是由于进行了重大重构或更改了环境 dev.nix 文件所致），请打开命令面板（在 Mac 上为 Cmd+Shift+P，在 ChromeOS、Windows 或 Linux 上为 Ctrl+Shift+P）并运行 Hard Restart 命令。如果无效，请尝试运行重新构建环境命令。

我的工作区无法响应，加载时只会显示空白屏幕

如果您的工作区无响应，您可以尝试重置虚拟机。为此，请按以下说明操作：

1. 在 Firebase Studio 中，点击更多 ( more_horiz ) 菜单，然后选择重置。

2. 当系统提示时，再次点击重置。

3. 重新打开您的工作区。

在创建工作区时，我看到一条消息“糟糕…我们需要启动新的虚拟机”，然后界面会卡住。

Firebase Studio 会维护一个虚拟机暖池，用于按需预配工作区。当空闲工作区池耗尽时，系统会在启动新虚拟机后预配工作区。此过程可能需要一些时间（有时长达五分钟），但最终会成功。

[错误编号 28] 设备上没有剩余空间

如果磁盘已满，您可能会遇到此消息。Firebase Studio 工作区提供以下方面：

• 为 Nix 软件包和 /tmp 提供 100 GiB 的总磁盘空间
• 为 /home 目录提供 10 GiB

创建工作区时，我收到“发生内部错误”的提示。

在大多数工作区预配出现内部错误的情况下，等待约 1 分钟后刷新页面即可解决问题并进入工作区。

我可以创建多少个工作区？

Firebase Studio 免费方案允许每位用户最多可以创建三个工作区。您可以加入 Google Developer Program，将可创建的工作区数量增加至最多 10 个。如需升级到 30 个工作区，请订阅 Google Developer Premium Program。

如何提交功能请求或针对遇到的问题提供反馈？

如果您在使用 Firebase Studio 时遇到问题或者希望提交功能请求，请与 Firebase 支持团队联系。

我之前在 Firebase Studio 中使用的某个功能现在找不到了。为什么它被移除了？

Firebase Studio 中的部分功能仍属于实验性质。我们重视您的反馈，并将其用于优化当前及规划中功能集，同时会定期剔除未达您或我们期望的功能。如果您希望在理想的 Firebase Studio 版本中看到某些功能，请向我们发送反馈。我们期待听到您的反馈！

Firebase Studio Code 工作区

我的工作区已加载，但模拟器仍然空白。

我们正在持续优化云端模拟器的可靠性。如果刷新页面无法解决问题，请向 Firebase 支持团队报告问题。

一些 Firebase Studio 工作区具有与我的项目不兼容的 Flutter 版本。

您可以像在本地机器上一样（使用 apt-get 或 brew），对工作区内几乎所有预安装的软件版本进行升级或降级。您可以在工作区中进行软件升级或降级，但这些更改不会跨会话保留。我们建议您在 dev.nix 文件中列出所有必需的软件包。

我们正在积极改进 Firebase Studio 中的 Flutter 版本管理。

我与他人共享了工作站网址，但对方无法看到该网址。

您只能与有权访问工作区的用户共享工作区网址。没有权限的用户在尝试访问该网址时会看到错误。请务必明确与其他用户共享工作区。

当我共享工作站时，协作者可以看到什么内容？

被添加到您工作区的用户可以访问虚拟机的整个文件系统，其中可能包含敏感文件，例如存储在磁盘上的私钥和访问令牌。仅与您信任的人共享工作区。虽然此方法有助于其他用户查看工作区的精确状态，但这意味着他们会看到您工作区中的所有内容。

我已共享工作区；为什么协作者无法发布或监控我的应用？

被添加到您的工作区中的用户可能未获得底层 Firebase 项目的访问权限，而该项目支持“应用概览”发布和监控功能。如需向其授予 Firebase 项目的权限，请参阅 Firebase 项目的权限和访问权限。

我可以使用 Firebase Studio 尚无模板支持的框架来构建应用？

可以！您可以自定义环境，以在 Firebase Studio 中使用几乎任何框架或语言。

将 Flutter 应用发布到 Firebase Hosting 时，应选择哪个目标目录？

选择 build/web 目录。此目录应包含 index.html，以及在 Web 应用成功构建（通过 flutter build web）后呈现该应用所需的所有静态资产。

如何在工作区中设置应用的后端，以便前端与其通信？

您可以暂时公开打开正在运行后端服务器的 TCP 端口，以便更轻松地在不同的工作区中分别开发前端和后端：

1. 在终端中手动启动后端或 API 服务器，或将其作为 dev.nix 文件的预览配置或 onStart 生命周期钩子的一部分启动。

2. 点击活动栏中的 Firebase Studio 图标（默认位于左侧），打开 Firebase Studio 面板。

3. 

   展开后端端口部分，查看正在运行的服务器列表，包括端口号和进程 ID (PID)。

4. 点击端口号左侧的 设为公开图标（一个锁）。

   警告：只要工作区处于活动状态且未明确关闭公开访问，任何人都可通过互联网访问您的端口。

5. 点击端口号右侧的 复制网址图标，复制其完全限定网址。

6. 现在，您可以直接从前端引用此网址（例如，使用 fetch 调用）。

   注意：如果您的前端是网络浏览器，您可能需要在后端或 API 服务器中启用 CORS 支持（例如，Node.js 应用可使用 cors NPM 软件包，Python Flask 应用可使用 flask-cors）。

我关闭了预览标签页。如何恢复该标签页？

按 Ctrl+Shift+P（在 macOS 上，按 Cmd-Shift-P）打开命令面板，然后选择“Firebase Studio：显示 Android 预览”或“Firebase Studio：显示网页预览”。

什么是 Code OSS？

Code-Open Source Software (Code-OSS) 是一个开源项目，该项目是 VS Code 的核心层。Code-OSS 在 GitHub 上以标准 MIT 许可的形式提供，Microsoft 正是在其中开发 VS Code 产品。

如何阻止系统将我的代码补全和 Gemini 对话提示用作训练数据？

使用 Firebase Studio 时，您必须遵守《Google 服务条款》。

不过，请注意，使用 Firebase Studio 中的生成式 AI 功能受《生成式 AI 使用限制政策》和《Gemini API 附加服务条款》的约束（具体受《Gemini API 附加服务条款：免费服务》的约束）。

如要禁止使用您的提示和回答来训练模型，请勿使用 App Prototyping agent，也不要在 Firebase Studio 中使用 Gemini in Firebase。如需阻止将您的代码用于模型训练，请在 Firebase Studio 设置中关闭代码补全和代码索引编制。

Gemini

如何查看自动生成的 Gemini API 密钥的每分钟请求配额？

您可以在 Google Cloud 控制台的Generative Language API 配额和系统限制页面上查看与您的自动生成 API 密钥关联的配额。

App Prototyping 代理

我无法创建项目

在配置 Gemini API 密钥等资源或部署到 Firebase App Hosting 时，系统会根据您的 Firebase Studio 工作区名称自动为您配置项目。

如果您收到“创建项目失败”错误，请执行以下操作：

• 如果您的 Google 账号属于某个组织，则您可能没有权限创建 Google Cloud 项目，或者您已达到项目配额限制。请与您的管理员联系以获取帮助，或参阅创建和管理项目。

• 如果您的 Google 账号不属于任何组织，则可能已达到 Google Cloud 项目配额限制。申请增加配额。

  如需详细了解项目配额，请参阅管理项目配额。

如需详细了解 Firebase 和 Google Cloud 项目，请参阅了解 Firebase 项目。

Cloud Billing 账号创建失败

在配置资源（例如部署到 Firebase App Hosting）时，您可以选择或创建 Cloud Billing 账号。

如果您收到“创建 Cloud Billing 账号失败”错误，请执行以下操作：

• 确保您有权创建 Cloud Billing 账号。请检查您的权限，或联系管理员寻求帮助。

如果您收到“此结算账号的项目过多”错误，请执行以下操作：

• 您可能已达到 Cloud Billing 账号的项目限制。您可以申请增加配额。 详细了解 Cloud Billing 账号配额。

如需详细了解如何创建 Cloud Billing 账号，请参阅创建新的自助结算账号。

如果这些选项都不能解决您的问题，请与 Cloud Billing 支持团队联系。

为什么 App Prototyping agent 没有提供解决我的问题的方案？

App Prototyping代理会检测 Next.js 错误并提供修复建议。如果您收到错误消息，但系统未提供解决方法，请复制问题文本并将其粘贴到聊天对话中。

为了获得最佳结果，请提供有关问题性质的更多信息（如果有的话）。

例如，如果您看到 Property access is undefined on object. for 'list' @ L6 等 Firebase 错误，这表明 Cloud Firestore 规则存在问题，请在错误前面加上“您能帮我解决此 Cloud Firestore 规则问题吗？”

我在发布后收到“未能发布应用”错误

如果发布失败，则系统通常会将可操作的错误记录到 Cloud Build 日志中。如需调试和解决发布失败问题，请执行以下操作：

1. 在应用详情页面（如果已最小化，请点击发布以显示该页面）中，点击查看详细信息。这会在 Firebase 控制台中打开 App Hosting。

2. 在Firebase控制台App Hosting页面中，点击查看 Cloud Build日志。

   此操作会打开 Firebase 控制台，您可以在其中查看 build日志并找到错误。

3. 复制错误并将其粘贴到 App Prototyping agent 或工作区的 Gemini in Firebase 对话中，然后请 Gemini 修复该错误。

4. 如需验证修复情况，请切换到代码视图，打开终端，然后运行 npm run build。如果您看到其他错误，请重试。如果您看到 FirebaseError，请参阅为什么 App Prototyping agent 没有提供解决问题的建议？。

5. build成功后，点击 npm run start 并打开提供的 localhost 链接，然后测试应用功能。您可以检查终端是否存在任何运行时错误。

6. 如果所有操作都成功，请在终端中按 Ctrl-C 以停止在工作区中运行的已发布版本 build，然后再次尝试 App Hosting 发布流程。