OpenLayers 通过 WFS-T 编辑要素
OpenLayers 通过 WFS-T 编辑要素，核心做法是用 ol/format/WFS 的 writeTransaction，把插入、更新、删除的 Feature 编成 WFS Transaction XML，再以 POST 发到 GeoServer 等 WFS 端点完成持久化。库本身没有“画完自动入库”的控件，需要你自己接 Draw / Modify / Select，序列化后发请求，再按响应刷新 VectorSource。截至 2026 年 11 月，OpenLayers 稳定版为 v10.11.0，默认 WFS 1.1.0，也可指定 1.0.0 或 2.0.0；服务端必须打开 Transaction，图层有主键且几何字段、投影与客户端一致，否则事务会失败。
动手前要先确认什么
WFS-T 解决的是「浏览器里改完几何或属性，要写回服务器数据库」的问题，不是单纯加载 WFS 只读图层。只读加载可用 bbox 策略拉矢量；事务编辑则必须走 Transaction，并处理好命名空间、几何列名、权限和跨域。
- 服务端：GeoServer（或其他 WFS-T 实现）WFS 服务级别设为 Transaction；要素类型有主键；写权限已授权（匿名角色或 Basic Auth）。
- 数据：几何类型与图层声明一致（Point 不要当成 MultiPoint）；几何字段名尽量用 geometry，否则插入后几何常为空。
- 客户端：地图与 srsName 投影一致（常见 EPSG:3857）；featureNS 用完整 URI，featurePrefix、featureType 与工作区图层一致。
- 网络：浏览器同源策略下需 CORS 或同源/代理；POST 的 Content-Type 一般为 text/xml。
若你还在选型前端库，可先看本站对 Leaflet 与 OpenLayers 的对比：Leaflet和OpenLayers选哪个?二者优劣对比?。选定 OpenLayers 后，编辑交互通常会用到要素选择，选中逻辑可参考OpenLayers点击事件：图层点击事件和坐标拾取。
用 writeTransaction 做增删改的步骤
官方提供的是格式化能力，不是完整编辑器。典型流程：交互产生变更 → 组装 inserts / updates / deletes → writeTransaction → XMLSerializer → fetch/ajax POST → 解析响应并刷新源。API 说明见 OpenLayers WFS 格式类文档。
- 安装并引入：项目里用 npm install ol（或 CDN 指向 v10.11.0）。引入 WFS，按版本需要再配合 GML / GML3 / GML32。
- 准备可编辑 VectorLayer / VectorSource，以及 Draw、Modify、Select。Draw 的 drawend 收集待插入要素；Modify 结束后把变更要素放进 updates；删除走 deletes。
- 创建格式实例，例如 new WFS({ version: ‘1.1.0’ })。调用 writeTransaction(inserts, updates, deletes, options)。options 中 featureNS、featurePrefix、featureType 必填；按需加 srsName、gmlOptions、hasZ、version。
- 用 XMLSerializer 把返回的 Node 转成字符串，POST 到例如 /geoserver/wfs。需要认证时在 headers 带上账号信息。
- 用响应文本调用 readTransactionResponse 确认成功与否；成功后清空或重新加载 VectorSource，让服务端生成的 FID 回到客户端，避免后续更新对不上 ID。
更新时注意：不要直接把带 boundedBy 的要素塞进 updates，一般先 clone，删掉 boundedBy，再 setId / setProperties。插入时若库表几何列不是 geometry，要在要素上 setGeometryName(‘实际列名’)，或把几何写到对应属性名上。只读加载示例可对照官方 vector-wfs 示例，编辑则在此之上自行加事务。
服务端与客户端关键配置对照
下面这些项对不上时，事务最容易“看起来发了请求，库里却没变”或直接报只读/信封外错误。
| 项目 | 建议值或要求 | 不匹配时常见现象 |
|---|---|---|
| WFS 服务级别 | Transaction（完整事务） | 只读、拒绝写入 |
| 主键 | 要素类型必须有 primary key | 无法事务 / 只读错误 |
| 几何字段名 | 优先 geometry；否则 setGeometryName | 插入成功但几何为空 |
| 几何类型 | 与图层、表约束一致 | 插入或更新失败 |
| srsName | 与地图、数据坐标一致 | OutsideEnvelope 等投影错误 |
| featureNS | 工作区命名空间 URI | XML 无效、更新失败 |
| WFS 版本 | 常用 1.1.0；2.0.0 需注意过滤器 | GeoServer 解析 FeatureId 等问题（较新版已改用 fes:ResourceId） |
| 权限 / CORS | 写权限 + CORS 或代理 | 401/403 或浏览器拦截跨域 |
若不想从零拼交互与事务，可评估第三方 Tiny 客户端 ol-wfst（面向 GeoServer，社区称兼容 OL 5–10 一带），用控件封装绘制、修改、删除和多要素事务；是否采用以项目依赖与维护策略为准，接口细节以该库仓库说明为准。
验收标准与出错怎么排
改完不要只看地图上的临时图形，要按下面标准验收：
- POST 返回 200，且 TransactionResponse 里有成功的 insert/update/delete 结果（有新 FID 或匹配条数）。
- 刷新或重新 GetFeature 后，几何与属性与编辑一致；新要素带服务端 ID。
- 同一要素再次更新仍能命中正确 ResourceId / FeatureId。
- 无几何为空、无 OutsideEnvelope、无权限拒绝。
排查顺序建议：先看 GeoServer 日志与返回 XML；再核对 featureType / featureNS / srsName；再检查几何列名与是否残留 boundedBy；最后查 CORS 与认证。小数漂移时可检查工作区小数位数等服务端设置。点要素很多时若叠加了聚合展示，编辑层与聚合层职责要分开，聚合实现可另见OpenLayers点聚合怎么实现?代码逻辑是什么?，避免把聚合图层直接当可写图层。
常见问题
插入成功但地图或库里几何是空的？
多半是几何列名不是 OpenLayers 默认的 geometry。创建或提交前对 Feature 调用 setGeometryName，指向表里的 geom / the_geom / wkb_geometry 等实际字段，或把几何写入对应属性；也可在库侧统一改成 geometry。
提示只读或事务被拒绝怎么办？
检查 WFS 是否开到 Transaction、图层有无主键、匿名或登录用户是否有写权限，以及客户端是否带上认证头。几何类型与图层声明不一致也会导致写入失败。
更新 XML 无效或 GeoServer 解析失败？
确认 featureNS 是 URI、更新前去掉 boundedBy，并尽量过滤 undefined 属性。使用 WFS 2.0.0 时，优先用较新的 OpenLayers（如 v10.11.0 一带），事务过滤器已改为 fes:ResourceId，可减少旧 FeatureId 兼容问题。
必须用第三方库吗？
不必。原生 writeTransaction + Draw/Modify/Select + fetch 即可完成完整 WFS-T。只有需要开箱控件、表单钩子或多图层管理时，再考虑 ol-wfst 这类封装；生产环境仍要自己处理 CORS、认证与刷新策略。
总结：OpenLayers 做 WFS-T 的关键是 writeTransaction → POST → 刷新源，并保证服务端 Transaction、主键、几何名与 srsName 一致。建议先在小图层用 WFS 1.1.0 跑通「画一个点 → 插入 → 改属性 → 删除」闭环，再接到正式权限与代理；交互与选择事件按本站点击事件教程拆开写，避免把加载、聚合、编辑全堆在一个图层上。