精选优惠 · 官方会场

轻量应用服务器

新用户专享

2核2G · 200M峰值带宽 · 40G系统盘

限阿里云新用户
68元/年限阿里云新用户
立即选购

云服务器 ECS

新老同享

经济型e · 2核2G · 3M固定带宽 · 40G盘

同主体限1台 · 不可叠券
99元/年同主体限1台 · 不可叠券
立即选购

云数据库 RDS

数据库精选

托管数据库 · 弹性扩容 · 自动备份

按地域与配置选择
查看活动价按地域与配置选择
查看优惠
更多阿里云活动收起阿里云活动
11月1日—30日企业至高减 1728 元

双11满减礼包

个人至高减360元;需对应实名认证,满减门槛及适用产品以官方规则为准。

前往官方会场
AI 专场让 AI 应用轻松上云

AI 产品特惠

浏览 Token Plan、Qoder 与 AI 应用等官方活动,按实际使用需求选择。

前往官方会场
搭配更省心服务器 + 数据库

云产品组合购

查看 ECS、RDS 等组合活动,按业务规模和实际预算搭配。

前往官方会场
官方活动合集热门云产品,一站选

云小站更多特惠

继续查看服务器、数据库与存储等优惠,选择适合自己的配置。

前往官方会场

阿里云 react 项目上线前的 7 项部署检查

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 或其他运行环境。上线验收时别只看首页,真实用户会直接打开的链接也要逐个检查。

赞 (0)
上一篇 2026年11月15日 上午3:25
下一篇 2026年11月15日 上午3:25

相关推荐

  • 阿里云秘钥登录怎么配置?创建步骤与常见排错方法

    管理阿里云 ECS 上的 Linux 服务器,可以用 SSH 秘钥登录,省去每次输入密码的步骤,也能减少密码被猜中的风险。配置时,光把私钥下载到电脑还不够:密钥要绑定到正确实例,连接用户名和网络规则也得匹配。下面按创建、绑定、连接的顺序说明,并列出几种常见故障的排查方法。 阿里云秘钥登录是什么 阿里云秘钥登录通常指通过 SSH 密钥对连接 Linux ECS…

    阿里云 2026年11月15日
  • 阿里云开放ftp端口,怎样配置更安全?

    FTP服务已经启动,客户端却连不上,问题往往不只在FTP软件。阿里云ECS的安全组、Linux系统防火墙和FTP服务配置都可能影响连接;使用被动模式时,数据端口也必须正确放行。下面以Linux云服务器为例,说明阿里云开放ftp时需要检查的设置和常见故障。不同发行版及FTP软件的配置文件、服务名称可能不同,动手前先确认服务器系统和实际使用的服务端程序。 先确认…

    阿里云 2026年11月15日
  • 阿里云smtp地址怎么填?端口和账号配置说明

    配置网站表单、邮件客户端或业务系统时,常会遇到“阿里云smtp地址”该填什么的问题。先确认你用的是哪项服务:阿里云邮件推送(DirectMail)主要用于网站验证码、订单通知和系统告警等程序化发信;阿里云企业邮箱则用于员工日常收发邮件。两种服务的 SMTP 地址和登录凭据并不通用,填错产品参数,即使密码没有问题,也可能连接失败或无法发送。 下面按常见场景整理…

    阿里云 2026年11月15日
  • foxmail登陆阿里云邮箱怎么设置服务器?常见问题与处理方法

    Foxmail登录阿里云邮箱:服务器设置与常见问题处理 在电脑上用Foxmail收发阿里云邮箱,通常需要邮箱地址、有效的登录凭据,以及正确的收发服务器参数。网页邮箱能正常登录,不一定表示Foxmail也能直接使用:账号可能限制第三方客户端访问,或要求使用专用密码。设置前先确认账号要求,再填写服务器信息,能少走不少弯路。 设置前先核对账号信息 阿里云企业邮箱常…

    阿里云 2026年11月15日
  • 周口阿里云代金券怎么领、怎么用?选购前留意这些细节

    在周口经营网店、门店,或承接网站和软件项目,可能会用到云服务器、对象存储、数据库等云产品。刚开始上云时,除了配置怎么选,费用怎么控制也得提前考虑。搜索“周口阿里云代金券”,通常是想弄清楚优惠从哪里领、能不能用于自己的订单,以及怎样避免领了券却抵扣不了。 有一点可以先确认:代金券能不能用,通常看账号情况、活动规则、适用产品和订单条件,不单由所在城市决定。周口用…

    阿里云 2026年11月15日
返回顶部