企业 AI 项目 Wiki · 环境、版本与上线

预发布环境

也常写作Staging environment · Pre-production environment · Stage · 预生产环境

定义

预发布环境是软件进入生产环境之前，用于对生产候选产物、环境配置和正式部署路径进行最后验证的受控非生产环境。它应尽可能复现与本次发布风险有关的生产条件，同时与真实用户、正式数据和不可逆业务操作保持隔离，使团队能在上线前发现由配置、权限、网络、依赖、数据迁移、启动和观测方式造成的问题。

预发布环境为什么单独存在

功能在测试环境通过，不代表同一产物能够按正式方式进入生产。生产前最后一段风险往往来自环境配置、身份权限、网络路径、证书、数据迁移、资源限制、启动顺序、监控和部署脚本，而不是单个页面功能。

预发布把验证对象从“某项功能是否可用”推进到“这一个生产候选版本能否沿正式路径部署并在生产相似条件下运行”。它应位于发布流程靠近生产的一端，变更频率低于普通测试环境，访问和部署也更受控制。

它仍然是非生产环境。除非另有受控方案，不应承载正式业务，也不应让测试请求修改真实订单、发送真实通知或使用不必要的生产数据。接近生产指复现有关风险，不是取消隔离。

哪些条件应尽量接近生产

不必同等成本复制所有部分。优先复现会影响本次发布结论的条件，并把保留差异登记出来。

架构和服务类型

关键计算、网络、数据库、缓存、消息、存储和网关的类型及连接关系应具有代表性，避免验证生产中不存在的路径。

运行时和部署产物

使用准备进入生产的同一不可变产物或可证明等价的产物，保持操作系统、基础镜像、运行时和关键依赖版本兼容。

部署与配置方式

尽量使用正式流水线、基础设施代码、配置注入、密钥引用、数据库迁移和启动顺序，不能靠手工修正掩盖发布问题。

身份、权限和网络控制

角色模型、服务账号权限、入口出口、专网、代理、DNS、证书和防火墙规则应体现生产限制，同时使用独立账号和密钥隔离环境。

监控、日志和健康判断

复现生产采用的日志、指标、调用链、健康检查和告警逻辑，验证发布后团队能否看见失败并采取行动。

资源与负载特征

若要得出性能或容量结论，资源、数据量、并发和依赖限额必须足够代表生产；缩小规格时要说明哪些结论无效。

已知差异清单

生产数据、真实域名、支付、短信、邮件、资源规模或区域可以不同，但要记录差异、原因、风险、补充验证和负责人。

上线前在这里验证什么

生产候选版本是否唯一？
确认应用、配置、数据库变更、模型、提示词和知识索引版本，验证期间不无记录替换。
记录：产物摘要、候选编号、配置与迁移版本。
正式部署路径能否完整执行？
从获取产物到配置、迁移、启动、预热和健康检查按生产方式执行，并保存每一步结果。
记录：流水线运行、部署日志、迁移和启动结果。
关键业务冒烟测试是否通过？
用少量高价值端到端场景确认登录、查询、写入、权限、集成和核心状态转换未被发布过程破坏。
记录：冒烟用例、输入、实际结果和执行人。
安全和环境边界是否正确？
检查域名、证书、网络、服务身份、密钥引用和最小权限，确保没有误连生产数据或真实动作端点。
记录：访问测试、策略差异、端点和账号清单。
监控和告警能否发现问题？
触发受控错误，确认日志、指标、调用链、告警接收人和运行手册能支持定位。
记录：受控故障、告警通知、诊断路径。
回退或停止方案是否可执行？
验证旧产物可取得、配置可恢复、数据库变更有兼容或恢复方法，并明确不可逆步骤前的停止点。
记录：回退演练、恢复结果、限制和负责人。

一次预发布验证怎样进入生产决策

冻结生产候选对象
从已完成常规测试的版本中选定候选产物，同时冻结本次发布包含的配置、迁移和依赖变更。
恢复已知环境状态
确认基础设施、账号、网络、数据基线和监控未被上一次验证污染，并登记与生产的差异。
沿正式路径部署
使用将用于生产的自动化和批准步骤部署同一产物，不在环境内重新构建，也不做未记录的手工修补。
执行最终验证
完成启动、健康、冒烟、关键集成、必要性能、安全、迁移和恢复检查，问题按严重程度记录。
确认上线条件
核对监控、告警、联系人、维护窗口、观察指标、停止条件和回退方案，由指定人员决定进入生产或退回修复。
保持产物连续性
批准后将已经验证的产物提升到生产；若重新构建、修改配置或修复问题，需要重新判断受影响的验证范围。

数据、外部服务和 AI 怎样处理

代表性数据不等于复制全部生产数据

优先使用合成或脱敏数据，保留必要的数据量、关系、边界和历史状态。确需生产样本时，要有授权、最小范围、访问限制和删除安排。

外部依赖要分清测试端和正式端

支付、短信、邮件、电子签名和企业接口应明确连接沙箱、模拟服务还是受限正式端点，防止冒烟测试产生真实副作用。

模型服务必须具有代表性

确认模型名、版本或别名、区域、过滤、参数、配额和备用路径。测试模型与生产模型不同，就不能直接证明输出质量或延迟。

知识状态与候选版本绑定

记录文件版本、权限、切分、索引、检索和重排配置，确认更新、删除和引用行为；验证中不允许索引无记录变化。

工具调用阻断真实副作用

订单、消息、工单、审批和付款使用测试端点或严格受限账号，验证参数、确认、幂等、审计、失败和人工接手。

环境污染和持续费用受控

演示、压测和多人共用后重置数据与配置；记录生产相似资源、第三方账号和模型调用的保留周期、配额和负责人。

预发布环境容易与什么混淆

相关概念	与预发布环境的区别
测试环境	测试环境用于较广泛的功能、集成、异常和回归测试，允许频繁变更；预发布更靠近生产，验证冻结候选版本和正式部署路径。
UAT 环境	UAT 供业务用户依据验收场景确认业务结果；预发布强调生产相似技术条件和上线风险。可以共用资源，但对象、权限和结论要分开记录。
生产环境	生产承载真实业务和正式运行责任；预发布不应因配置相似就获得不必要的生产数据、密钥或真实操作权限。
发布候选版本	候选版本是准备进入生产的软件、配置或内容状态；预发布环境是部署和验证它的地方。
蓝绿部署中的绿色环境	绿色环境是生产发布策略中的新版本运行面，可能随后接收真实流量；预发布是独立非生产验证环境。技术上可通过槽位交换相连，责任仍不同。
演示环境	演示环境以稳定展示为目标，可能固定数据并简化依赖；预发布以发现生产发布风险为目标，不应被长期演示需求冻结。

依据与适用边界

本文所说的预发布环境，是紧邻生产发布之前、用于最终技术验证的非生产环境。团队也可能称它为 staging、stage 或 pre-production，这些名称没有全球统一的规模和测试范围。本文不把预发布环境默认等同于 UAT 环境，也不要求复制全部生产数据、容量或真实外部操作。是否独立设置、复现哪些生产条件和使用什么数据，必须按项目风险确认。