OpenLayers 加载 WFS 时的坐标系处理
OpenLayers 加载 WFS 时，坐标系处理的核心是让矢量要素的投影与地图 View 投影一致：优先在 GetFeature 请求中用 srsName 指定与地图相同的 CRS；若服务端只能返回另一套 CRS，则在 ol.format.WFS 与 VectorSource 中分别设置 dataProjection（数据原始投影）和 featureProjection（地图目标投影），必要时先用 proj4 注册自定义坐标系再转换。投影不匹配会出现整体偏移、缩放到错误位置或图层空白。截至 2026 年 11 月，建议使用 OpenLayers 稳定版 v10.11.0，并对照官方 Vector 与 WFS 格式文档核对参数。
为什么 WFS 图层容易出现坐标偏移
WFS 返回的是矢量要素，坐标写在 GML 或 GeoJSON 里，本身不带瓦片金字塔。OpenLayers 地图 View 默认常用 Web 墨卡托（EPSG:3857），而很多 WFS 服务默认输出地理坐标（EPSG:4326）或业务库里的地方坐标系。两者数值差几个数量级，若不做转换，要素会落到地图外或海里。
- 服务端 DefaultCRS 与地图 View 投影不同，且请求未带 srsName。
- format 只解析了几何，未声明 dataProjection / featureProjection。
- 自定义 EPSG 未注册到 ol.proj，转换直接失败或静默用错轴序。
- GML 里带有 srsName，但客户端忽略，仍按默认 3857 解读。
这类问题与底图瓦片错位类似，但 WFS 没有“级别对齐”可依赖，只能靠投影参数一次做对。若已出现大幅偏移，可对照本站OpenLayers 坐标偏移排查与坐标转换说明先排除轴序和单位问题。
加载前如何确认 WFS 服务的坐标系
动手写代码前先核对服务能力，避免盲试。
- 请求 GetCapabilities，在 FeatureTypeList 中找到目标图层的 DefaultCRS / OtherCRS（或 SRS）。
- 确认服务是否支持你地图所用的 EPSG；若只支持 4326，后续必须在客户端转换。
- 用桌面 GIS 或浏览器直接拼一条 GetFeature（带 srsName）看返回坐标数值量级：经纬度约在 ±180/±90，墨卡托则是百万级米制坐标。
- 记录输出格式（GML2/GML3/GeoJSON）。GeoJSON 在 OpenLayers 里通常更易指定投影；GML 则依赖 WFS format 的正确解析。
核对清楚后再决定：服务端重投影，还是客户端用 dataProjection + featureProjection。
用 OpenLayers 正确加载并转换坐标系的步骤
面向可执行配置，按下列顺序做，每步都能单独验收。
- 确定地图 View 投影（例如 EPSG:3857），创建 Map 与 View 时写死 projection。
- 构造 WFS GetFeature URL 或使用 loader：尽量带上 srsName=EPSG:3857（或你的 View CRS）。能让服务端直接输出目标投影时，客户端可少一次转换。
- 创建 ol.format.WFS（或配合 GeoJSON format）。在读入要素时传入 dataProjection（服务实际返回的 CRS）和 featureProjection（地图 View CRS）。
- 用 VectorSource 的 loader / url + format 加载；若用自定义 loader，在解析后显式调用 format.readFeatures(data, {dataProjection, featureProjection})。
- 把 VectorLayer 加到地图，缩放到要素范围（fit），目视检查是否压盖底图道路、行政区界。
| 参数 | 含义 | 典型取值与注意 |
|---|---|---|
| dataProjection | WFS 返回数据本身的 CRS | 与 GetCapabilities / 响应里 srsName 一致，常见 EPSG:4326 |
| featureProjection | 写入地图要素时使用的 CRS | 必须等于 View 的 projection，常见 EPSG:3857 |
| srsName（请求参数） | 告诉 WFS 服务按哪套 CRS 输出 | 优先设成与 featureProjection 相同，减少客户端转换 |
VectorSource 与 WFS format 的具体选项可在官方文档中核对：ol/source/Vector API、ol/format/WFS API。版本请以 OpenLayers 官网下载页 当前稳定版为准（撰写时为 v10.11.0）。
自定义坐标系与投影注册怎么做
业务库常见 CGCS2000 高斯投影、地方独立坐标系等，OpenLayers 内置没有定义时，必须先注册再转换。
- 用 proj4 定义投影字符串或 WKT，再调用 ol.proj.proj4.register，使 EPSG:xxxx 可被识别。
- 注册后再把该 EPSG 用作 dataProjection 或 featureProjection。
- 轴序（lon/lat 还是 lat/lon）、单位（度还是米）写错会导致“看起来转换了但仍偏移”。
投影注册与自定义转换的完整步骤见本站OpenLayers 投影注册：自定义坐标系和投影转换。若转换后仍有固定方向偏移，再结合坐标偏移排查教程检查是否把地理坐标当成了投影坐标。
常见报错排查与验收标准
先区分“请求失败”和“请求成功但位置错”。
- 控制台 CORS / 404：服务地址、代理或类型名写错，与投影无关，先打通网络。
- 要素数量为 0：filter、typenames 或输出格式不匹配，检查 GetFeature 原始响应。
- 有要素但 fit 后空白或漂到海里：几乎一定是 dataProjection / featureProjection 反了或未设置。
- 局部正确、整体平移：可能是自定义投影参数（中央经线、假东假北）与库不一致，回查注册定义。
验收标准建议写进自己的检查清单：
- 同一位置用已知控制点（或底图道路交叉口）目视压盖，误差在可视比例尺下可接受。
- 切换缩放级别后要素不“跳动”。
- 关闭/打开图层再加载，坐标仍稳定（排除 loader 里写死错误投影）。
瓦片底图本身若也不显示，可先排除 WMTS/离线瓦片问题，参见OpenLayers 加载 WMTS 离线瓦片不显示排查，避免把底图问题误判成 WFS 投影问题。
常见问题
地图是 EPSG:3857，WFS 只提供 EPSG:4326，必须改服务吗？
不必。请求时可尝试 srsName=EPSG:3857；若服务拒绝，就在客户端把 dataProjection 设为 EPSG:4326、featureProjection 设为 EPSG:3857，由 OpenLayers 完成转换即可。
GML 响应里已经写了 srsName，还要不要设 dataProjection？
建议显式设置。部分解析路径会读取 GML 内的 srsName，但显式传入 dataProjection 更稳妥，避免不同 format 版本行为差异导致静默用错投影。
加载后要素整体偏移几百米到几公里，怎么快速定位？
先打印一两笔要素坐标看数量级：若仍是经纬度却按米制底图显示，就是未转换。再核对自定义投影是否已 register，以及轴序是否颠倒。系统排查可参考本站坐标偏移专题。
自定义地方坐标系转换后局部准、远处不准，是什么原因？
多半是投影参数（中央经线、比例尺因子、假东假北）与数据生产时不一致，或混用了不同椭球。回到数据提供方确认完整 proj 定义，重新注册后再测控制点。
处理 OpenLayers 加载 WFS 的坐标系，优先让服务按地图 CRS 输出；做不到时再在 format / source 中成对设置 dataProjection 与 featureProjection，自定义 CRS 必须先注册。建议每次接入新服务都先看 GetCapabilities，再用控制点做压盖验收，避免上线后才发现整层偏移。