前端页面在本地能正常发送 AJAX 请求,部署到阿里云服务器后却出现跨域报错、接口超时或数据无法返回,通常要从请求地址、网络端口、HTTPS 和代理配置几处排查。AJAX 代码本身未必有问题,常见原因是本地开发环境与线上访问路径不同,服务器各层配置没有对应起来。
下面用一个商品查询页面说明部署时要检查什么:前端页面放在阿里云 ECS 上,后端提供商品接口。按浏览器发起请求、Nginx 转发、后端返回数据的顺序检查,比只盯着页面上的“请求失败”更容易找到问题。
先确认 AJAX 请求发往哪里
AJAX 是浏览器异步请求接口的常见方式。前端可以使用 XMLHttpRequest、fetch 或 jQuery 发起请求,再根据服务器返回的数据更新页面。例如:
$.ajax({ url: ‘/api/products’, method: ‘GET’, success: function(data) { console.log(data); } });
这里的 /api/products 是相对地址,浏览器会把请求发送到当前页面所在的域名和协议下。如果页面运行在 www.example.com,请求就会访问 www.example.com/api/products。如果接口另在 api.example.com:8080,两者的域名或端口不同,浏览器会按跨域规则检查响应。
还要分清两类问题:服务器是否能连上接口,取决于服务状态、网络和端口配置;浏览器是否允许前端读取响应,则可能与同源策略和 CORS 配置有关。跨域报错不等于后端一定没启动,接口连不上也不一定是 CORS 导致的。
案例:本地接口怎样接入阿里云服务器
假设商品页面在本地通过 http://localhost:8080/api/products 请求后端。上线后,前端放在阿里云 ECS,绑定域名 www.example.com,后端仍监听 8080 端口。若代码里保留 localhost,访问页面的用户会请求自己电脑上的 8080 端口,而不是 ECS,因此线上请求无法按预期到达服务器。
可以把接口地址改成服务器可访问的地址,也可以让 Nginx 做同域反向代理。后一种方式下,浏览器请求 https://www.example.com/api/products,Nginx 再把请求转发到 ECS 本机的后端服务。前端与接口使用同一来源,地址也更简单;如果后端只供 Nginx 调用,通常无需将业务端口直接开放给公网。
上线前检查四项配置
1. 检查后端服务和监听地址
先确认后端进程已经启动,再核对它监听的端口和地址。可以在 ECS 内发起本机请求,看看接口是否能正常返回,这一步能先排除应用路由、数据库连接等后端自身问题。
如果后端只监听 127.0.0.1,外部机器不能直接访问它,但同一台 ECS 上的 Nginx 可以转发请求。采用反向代理时,这种配置通常更合适。若计划从公网直接访问后端,则还需确认监听地址和网络规则都允许相应流量。
2. 配置安全组和系统防火墙
阿里云 ECS 安全组负责控制实例的入站、出站流量。网站对外提供 HTTP 或 HTTPS 服务时,安全组需要放行实际使用的端口;使用 Nginx 反向代理时,后端业务端口一般不必对公网开放。
服务器操作系统的防火墙也要检查。安全组已经放行,但系统防火墙仍拦截流量,同样会导致连接失败。排查时不要长期开放所有端口,按网站和接口实际需要设置规则,并确认 Nginx 能访问后端服务。
3. 按实际架构处理跨域
如果前端和接口确实使用不同来源,后端需要返回匹配的 CORS 响应头,包括允许的前端来源、请求方法和请求头。来源应与页面实际使用的协议、域名和端口对应。若请求带有 Cookie 或其他凭证,还需要明确允许凭证;这种情况下不能把允许来源设为通配符 *。
带有特定请求头或使用某些请求方法时,浏览器可能先发送 OPTIONS 预检请求。后端或代理要能正确处理这个请求,否则浏览器不会继续发送正式请求。不要依赖浏览器插件或关闭安全限制来“修复”跨域:这只影响本机调试,不能替代线上配置。若前后端可以通过 Nginx 同域访问,通常可以省去这部分跨域处理。
4. 让页面和接口都走 HTTPS
页面已经使用 HTTPS,却通过 AJAX 请求 HTTP 接口时,浏览器可能会按混合内容拦截请求。为网站配置证书后,还要检查前端接口地址和 Nginx 转发目标,确保用户访问的接口也使用 HTTPS。排查时留意重定向规则,避免页面已经加密,接口请求却仍指向明文 HTTP 地址。
Nginx 反向代理示例
如果后端服务运行在 ECS 本机的 8080 端口,可以在 Nginx 站点配置中加入类似规则:
location /api/ {
proxy_pass http://127.0.0.1:8080/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
需要留意 proxy_pass 末尾的斜杠。它会影响请求路径如何拼接,配置不匹配时,后端收到的地址可能多出或少了 /api/ 前缀。修改配置后,先检查 Nginx 语法,再平滑重载服务;随后用浏览器或命令行实际请求接口,确认转发路径与后端路由一致。
前端可以请求同源地址,并在失败时记录状态码和响应内容:
$.ajax({ url: ‘/api/products’, method: ‘GET’, dataType: ‘json’, timeout: 10000 }).done(function(data) { console.log(data); }).fail(function(xhr) { console.error(xhr.status, xhr.responseText); });
设置超时时间后,页面不会无限等待;失败回调中的信息也有助于区分接口错误、网关错误和网络超时。示例中的路径和端口只是说明用法,实际配置要按后端路由和服务端口调整,不能直接照搬。
常见故障怎么排查
- 浏览器提示跨域:先核对请求的协议、域名和端口,再查看后端 CORS 响应头;如果有 OPTIONS 预检请求,确认后端或 Nginx 能正确响应。
- 请求超时或无法连接:依次检查后端进程、监听端口、阿里云安全组、系统防火墙,以及 Nginx 配置里的转发目标。
- 接口返回 404:对照前端请求路径、后端路由和 Nginx 的路径拼接规则,检查是否多了或少了路径前缀。
- 接口返回 502:检查 Nginx 是否能连接后端,确认服务已经启动、端口正确,代理目标地址也能从 ECS 本机访问。
- 本地正常、线上失败:检查代码或环境配置中是否还留着 localhost、测试环境域名,或指向 HTTP 接口的地址。
排查时打开浏览器开发者工具的 Network 面板,查看请求 URL、状态码和响应头,再结合控制台提示判断问题出现在哪一段。服务器的访问日志和错误日志也能提供线索。页面只显示“请求失败”时,不要急着改 AJAX 代码,先确认请求实际发到了哪里。
上线后也要留意接口维护
接口需要鉴权时,不要把密钥写在前端代码里,因为浏览器端代码可以被用户查看。后端应校验请求参数,避免把数据库错误等内部信息直接返回给用户;根据业务情况设置超时和限流,并记录必要的请求日志。后端更新或重启时,前端也应提示请求失败,而不是一直停留在加载状态。
阿里云服务器 AJAX 项目上线时,先确认接口服务可用,再核对域名、协议和端口,随后检查安全组、防火墙及 Nginx 转发。前后端分属不同来源时再配置 CORS;如果采用 HTTPS 和同域反向代理,浏览器侧的跨域问题通常更容易避免。按“浏览器请求—代理转发—后端响应”的顺序逐层检查,能更快缩小故障范围。