React 项目能不能顺利上线,先看它需要什么运行环境。普通单页应用构建后会生成 HTML、CSS、JavaScript 和图片等静态文件,可以放到阿里云 OSS;使用 Next.js 服务端渲染,或依赖 Node.js 中间层的项目,则需要 ECS、容器服务等能运行服务端代码的环境。
下面以 Vite 创建的活动报名页面为例,检查从本地构建到正式访问容易遗漏的环节。案例采用 OSS + CDN,适用于不需要服务端运行的前端项目。
一、先确认部署架构
- OSS + CDN:适合官网、活动页和管理后台前端等静态站点。需要配置存储空间、访问权限、域名和 HTTPS。
- ECS + Nginx:适合需要运行服务端程序,或需要自行控制 Web 服务的项目。服务器、Nginx 和安全设置也要自行维护。
- 前后端分离:React 页面可以部署在 OSS 或 ECS,接口运行在独立服务中。前端请求接口时,要检查 HTTPS、跨域和鉴权配置。
如果页面只负责展示和交互,OSS 通常更省维护工作;项目必须运行 Node.js 服务时,再选择 ECS 或其他适合的托管环境。
二、上线前的 7 项部署检查
1. 检查构建配置和文件路径
先确认项目在本地可以正常运行,再检查路由、图片路径和接口地址。Vite 项目执行 npm run build 后通常生成 dist 目录;Create React App 的构建目录通常是 build。部署时上传构建产物即可,不要把整个源代码目录或 node_modules 一并发布。
如果网站部署在根域名下,Vite 的资源基础路径一般保持默认设置即可。若站点放在子目录,例如 example.com/event/,要按实际访问路径设置 base,否则页面可能能打开,但脚本和样式文件会加载失败。
2. 核对生产环境变量
开发环境和线上环境通常使用不同的接口地址。Vite 项目可以在构建前设置 VITE_API_BASE_URL,再由代码读取。凡是打包进前端的变量,浏览器用户都有机会查看,因此不能放数据库密码、云账号密钥或其他私密凭证。
活动报名表单应请求已部署的 HTTPS 接口。接口若只提供 HTTP,浏览器可能会因混合内容限制拦截请求;前后端使用不同域名时,还需要在接口服务端允许相应的跨域来源。
3. 本地验收生产构建
执行项目的构建命令,并确认没有报错。构建完成后,用本地静态服务器预览生成的文件,测试表单提交、图片显示、移动端布局和页面刷新。开发模式下表现正常,并不能保证生产构建也正常。
4. 创建 OSS Bucket 并检查权限
在阿里云控制台创建 OSS Bucket,选择适合目标用户访问的地域,并根据业务设置访问方式。公开网站需要允许访客读取页面文件,但不必开放写入权限。上传前检查文件清单,避免把测试配置或含有敏感信息的文件发布出去。
使用自定义域名时,按 OSS 控制台的要求完成绑定和验证。网站需要通过 CDN 访问时,也要按控制台流程配置回源。权限、域名验证和证书要求可能随配置不同而变化,以当前控制台说明为准。
5. 上传构建产物并设置首页
将 dist 目录里的文件上传到 Bucket 根目录。不要直接把整个 dist 文件夹当作网站根目录,除非你已经按对应路径配置了访问地址。之后将首页文档设为 index.html,并先用控制台提供的访问方式确认首页和静态资源都能读取。
6. 配置 React 单页应用路由回退
React Router 等前端路由由浏览器处理。用户直接打开 /register,或在这个页面刷新时,服务器可能会去查找名为 register 的文件,结果返回 404。需要在静态网站或 CDN 规则中,将页面请求回退到 index.html,由 React 根据路径显示对应页面。
回退规则不能不加区分地处理所有 404。否则缺失的 JavaScript 文件也可能返回 HTML,浏览器会报脚本解析错误。发布后分别测试首页、二级路由和不存在的静态资源地址。
7. 绑定域名并启用 HTTPS
配置自有域名后,按要求完成 DNS 解析和域名验证,再为访问链路配置有效的 HTTPS 证书。检查证书是否覆盖目标域名,页面中的图片和接口也应通过 HTTPS 加载。首次部署可以先用测试域名验收,再切换正式域名。
三、选择 ECS + Nginx 时的额外检查
使用 ECS 时,通常需要先将构建产物传到服务器,再由 Nginx 提供静态文件。Nginx 要设置正确的站点根目录,并为 React 路由配置入口回退。安全组只开放业务所需端口;SSH 管理端口应限制来源,不要无条件对所有地址开放。
服务器还需要维护系统更新、访问日志、磁盘空间、进程和备份。如果项目只是静态页面,这些工作未必划算;若必须运行 SSR 或自定义服务,则应结合资源需求和运维能力选择方案。
四、上线后检查访问和缓存
- 走一遍主要页面:打开首页和常用路由,测试刷新、表单、图片及手机端显示。
- 检查网络请求:确认 JS、CSS 和图片返回正常状态码,接口没有跨域或证书错误。
- 按文件类型设置缓存:带哈希的构建文件适合长期缓存;
index.html不宜长时间缓存,否则用户可能仍加载旧版本资源。更新后按实际缓存策略刷新 CDN 内容。 - 保留可回滚版本:保存每次构建产物和版本记录。新版本出现问题时,可以恢复上一版文件。
例如,活动报名页面上线后,用户能打开报名链接,但刷新二级页面会遇到 404。若文件上传正常,问题可能出在单页应用没有配置路由回退。将页面请求回退到 index.html,同时保留静态资源原有的错误响应,再测试刷新和资源加载,才能避免用首页正常掩盖其他问题。
阿里云 React 项目上线前,至少要确认部署方式、构建文件、接口地址、路由回退、域名、HTTPS 和缓存策略。纯静态项目可以从 OSS + CDN 开始;需要运行服务端代码时,再评估 ECS 或其他运行环境。上线验收时别只看首页,真实用户会直接打开的链接也要逐个检查。