> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 独立测试环境

> 已上线项目可开启与线上隔离的测试后端，用于验证数据、登录和第三方对接（限时免费，以产品内为准）。

## 这是什么

用一句话说：给你**已经上线**的项目，再开一套「练习用 / 试错用」的后端。

这套环境和真正给用户用的线上环境互相隔离，改坏了一般也不会动到线上。

可以把它理解成：

* **线上环境** = 正式开门营业的店
* **测试环境** = 仓库后厨 / 试菜间

你在试菜间怎么折腾，默认都不会自动变成店里给客人上的菜。

<img src="https://b.ux-cdn.com/uxarts/files/t20260831110420/hqd1osvf.png" alt="superun 云计算中的独立测试环境入口" width={900} />

***

## 解决什么问题

上线后你可能还想：

* 试一下新的登录方式会不会坏
* 改数据库、加字段，先别直接动正式数据
* 对接微信 / 支付 / 第三方回调，先用一套「测试地址」验证

如果直接在线上试，一不小心就会影响真实用户。独立测试环境就是为这种「上线后再验证」准备的。

***

## 在哪里找

1. 打开你的项目。
2. 进入 **研发 → 技能库 → superun 云计算**。
3. 打开 **「测试环境」** 标签（上方可能有 **FREE / 限时免费** 标识）。

<Note>
  该 Tab 目前主要在国内站展示（以产品内入口为准）。项目须**已发布上线**，并使用 **superun 云计算**；只连接自有 Supabase 的项目不会显示该入口。
</Note>

***

## 谁能用

| 角色        | 能做什么         |
| --------- | ------------ |
| 项目所有者     | 开启、重试、重建测试环境 |
| 所有者 + 编辑者 | 可查看测试环境配置    |
| 其他人       | 看不到该入口内容     |

开启前会弹出确认框，请先读完规则。确认按钮可能有短倒计时，防止误点。

***

## 测试环境与线上差在哪

### 1. 互相隔离

测试环境有自己的：

* 访问地址（URL）
* 数据库里的数据
* 登录 / 认证配置

在测试环境里改的东西，**不会自动同步到线上**；环境被回收后，测试侧改动也不会保留。

### 2. 数据从哪来

测试数据通常来自**近期线上备份**（首次进入或每日回收后再进，常按今日 / 昨日线上备份准备）。

因此：

* 可能仍含有接近真实的数据，请按敏感数据标准谨慎使用
* 不要把测试配置 / 密钥发给第三方当正式配置

### 3. 闲置会被回收

闲置的测试环境会在**每天凌晨 2 点**被回收，避免长期占资源。若当时项目仍在活跃使用，系统可能保留测试环境。回收后再进会从近期线上备份自动恢复，期间云工具与测试构建暂不可用；测试环境里做的改动也可能丢失。

### 4. 第一次要等一会儿

首次开启，或每天回收后再进，都要等系统准备好。页面上会显示进度（例如：分配资源 → 从备份建库 → 发布测试服务）。请保持页面打开，耐心等待。

***

## 开启后你会看到什么

准备好之后：

* 顶部会提醒：你现在配的是**测试环境**，URL / 数据 / 认证都不是线上那套
* 下面可以像配置云计算一样，查看 / 管理这套测试后端
* 所有者还能点 **「重建测试环境」**

***

## 「重建」是什么意思

**重建** = 删掉当前测试环境，再按最新线上备份重开一套。

请注意：

* 测试环境里的表数据、认证配置、其它改动会**永久丢失**
* **线上不会受影响**
* 重建期间测试环境暂时不可用，需要再等一段时间

适合：测试环境弄乱了、想重新从正式数据拷一份干净的。

***

## 费用

产品上标了 **「限时免费」**（入口常见 **FREE** 标识）。以后是否长期免费，以页面最新说明为准。

***

## 建议你怎么用

**适合：**

* 上线后再验登录、数据库、接口
* 给第三方填「测试回调地址」前，先在测试环境跑通
* 想大胆试错，又不想动正式用户数据

**务必注意：**

* 看清当前是测试还是线上（URL 不一样）
* 不要把测试环境的地址 / 密钥当成正式配置交给合作方
* 重要验证尽量当天做完——凌晨可能被回收
* 只有所有者能开；需要开的话找项目主人
* 每次恢复或重建后，重新验证认证、Edge Function、Webhook 和第三方回调
* 不要把重要数据或配置的唯一副本只保存在测试环境中

**不适合指望：**

* 把测试环境当长期正式环境用
* 以为测试里改的数据会自动同步到线上
* 没上线的项目直接开测试环境

***

## 最简流程（三步）

1. 先把项目**发布上线**。
2. 项目所有者打开 **云计算 → 测试环境**，点 **「开启测试环境」**，确认规则。
3. 等状态变成就绪后，用测试环境的配置去做验证；搞乱了就 **重建**。

需要把验证结果推到线上时，仍通过 **运营 → 发布**；测试环境里直接改的表数据、用户或配置不会自动上线。

***

## 一句话记住

测试环境 = 已上线项目的独立后厨：能试错、和正式店隔离，但会定时收摊，且数据可能来自正式店的备份。

***

## 常见问题

<AccordionGroup>
  <Accordion title="为什么无法开启测试环境？">
    请确认项目已上线、已启用 superun 云计算、正在国内站使用，并且你是项目所有者。只连接自有 Supabase 的项目不会显示入口。编辑者可以查看，但不能开启、重试或重建。
  </Accordion>

  <Accordion title="没上线的项目能开测试环境吗？">
    不能。项目必须已发布上线后才能开启。
  </Accordion>

  <Accordion title="测试环境里改的数据会同步到线上吗？">
    不会。测试与线上互相隔离；回收或重建后，测试侧改动也不会保留到线上。
  </Accordion>

  <Accordion title="为什么页面一直显示正在准备？">
    建库、恢复配置、Edge Function 与测试构建是异步完成的。请保持页面打开并等到「已就绪」。若明确失败，所有者可重试；长时间卡在同一阶段时，请携带项目 ID 与当前阶段联系支持。
  </Accordion>

  <Accordion title="凌晨回收后怎么办？">
    再次进入会从近期线上备份自动恢复，或由所有者重新开启；此前测试环境内的改动可能丢失。
  </Accordion>

  <Accordion title="重建会影响线上站点吗？">
    不会。重建只删除并重建测试环境；线上继续运行，但当前测试环境中的数据和配置会被永久丢弃。
  </Accordion>

  <Accordion title="第三方服务应该配置哪个地址？">
    测试验证用测试环境地址，正式对外用线上地址。两套不同，切换时请同步更新回调、Webhook、白名单和凭证。
  </Accordion>

  <Accordion title="协作编辑者可以开启吗？">
    不可以。只有项目所有者可以开启、重试或重建；编辑者可以查看配置。
  </Accordion>
</AccordionGroup>

## 相关文档

* [superun 云计算](/zh-Hans/superun/integrations/cloud)
* [发布](/zh-Hans/superun/features/publish)