GeoESB中/rest地图服务代理为何返回404或跨域错误？

Question

在GeoESB中配置 `/rest` 地图服务代理时，常出现 404 或跨域（CORS）错误。404 多因代理路径映射不匹配：如后端地图服务实际地址为 `https://gis.example.com/arcgis/rest/services/...`，但GeoESB中代理规则误配为 `/rest/**` 而未正确重写为 `/arcgis/rest/**`，导致请求被转发至不存在的路径。跨域错误则源于GeoESB未启用反向代理的 CORS 响应头（如 `Access-Control-Allow-Origin`），或前端直接调用代理路径却未通过GeoESB统一出口（绕过代理直连源服务），触发浏览器同源策略拦截。此外，若GeoESB未开启 `http.proxy.preserveHost=true` 或未透传原始 Host 头，部分GIS服务（如ArcGIS Server）可能拒绝响应。排查需结合 GeoESB 日志、代理链路追踪及目标服务实际 REST 端点结构，确保路径重写、协议/端口一致性与响应头注入均正确配置。

Answer 1

```html

一、现象层：典型错误表征与前端可观测线索

• 浏览器控制台高频出现 404 Not Found（如请求 /rest/services/World/MapServer?f=json 返回 404）
• CORS 错误明确提示：Access to fetch at 'https://esb.example.com/rest/...' from origin 'https://app.example.com' has been blocked by CORS policy
• Network 面板中可见请求已抵达 GeoESB（状态码 200），但响应体为空或含 ArcGIS Server 的 404 HTML 页面
• 部分请求返回 502 Bad Gateway 或 503 Service Unavailable，暗示后端连通性或 Host 头校验失败

二、配置层：GeoESB代理规则核心参数对照表

配置项	错误示例	推荐值	影响范围
proxy.path	/rest/**	/arcgis/rest/**	路径重写失配 → 404
http.proxy.preserveHost	false（默认）	true	ArcGIS Server 拒绝非注册 Host 请求
cors.enabled	false	true	缺失 Access-Control-Allow-Origin 等头 → 浏览器拦截

三、协议层：HTTPS/HTTP 协议与端口一致性校验

GeoESB 代理链路必须严格保持协议、主机名、端口三要素与目标 GIS 服务一致。例如：

✅ 正确映射：
  GeoESB 入口：https://esb.example.com/rest/services/...
  重写后转发：https://gis.example.com/arcgis/rest/services/...

❌ 常见陷阱：
  - 后端为 HTTPS，GeoESB 配置了 HTTP 协议转发（证书校验失败）
  - 目标服务监听 6443 端口（ArcGIS Server 默认 HTTPS），但代理未显式指定 port=6443
  - 使用域名别名（如 gis-internal.local）但未在 GeoESB trust-store 中导入对应证书

四、链路层：基于日志与追踪的诊断流程图

flowchart TD
  A[前端发起 /rest/services/World/MapServer] --> B{GeoESB 是否匹配 /rest/** 规则？}
  B -->|否| C[返回 404 或 405]
  B -->|是| D[执行路径重写：/rest/ → /arcgis/rest/]
  D --> E{是否启用 preserveHost=true？}
  E -->|否| F[转发 Host=gis.example.com → ArcGIS Server 拒绝]
  E -->|是| G[注入 CORS 响应头？]
  G -->|否| H[浏览器拦截跨域请求]
  G -->|是| I[成功返回 JSON/Metadata]

五、增强层：生产环境高可用加固建议

• 为 ArcGIS Server 后端配置健康检查探针（GET /arcgis/rest/info），自动剔除异常节点
• 在 GeoESB 全局响应头中注入 Access-Control-Allow-Headers: X-Requested-With, Content-Type, Authorization，兼容各类前端 SDK（如 Esri Leaflet、ArcGIS JS API）
• 启用请求 ID 透传（X-Request-ID），串联 GeoESB 日志、Nginx access log、ArcGIS Server logs 实现全链路追踪
• 对 /rest/services/**/MapServer/export 等大文件导出接口，配置超时延长（http.proxy.timeout=120000）与缓冲区调优

```