GeoServer SLD分类:点线面样式配置
GeoServer 用 SLD(Styled Layer Descriptor)按几何类型配置图层样式:点用 PointSymbolizer,线用 LineSymbolizer,面用 PolygonSymbolizer。截至 2026 年 10 月,生产环境推荐 Stable 版 GeoServer 3.0.2。在管理界面 Data → Styles 新建或上传 SLD,再在图层 Publishing 页设为默认样式即可生效。配置时重点核对 Graphic、Stroke、Fill、比例尺范围以及几何字段是否与图层一致。

点线面分别对应哪种 Symbolizer
SLD 根元素是 StyledLayerDescriptor,内部通过 NamedLayer / UserStyle → FeatureTypeStyle → Rule → Symbolizer 描述绘制规则。向量样式主要靠三类 Symbolizer 区分几何:
| 几何类型 | Symbolizer | 核心子元素 | 典型参数 |
|---|---|---|---|
| 点 | PointSymbolizer | Graphic(Mark 或 ExternalGraphic) | WellKnownName、Size、Fill、Stroke、Rotation |
| 线 | LineSymbolizer | Stroke | stroke、stroke-width、stroke-dasharray、linecap/linejoin |
| 面 | PolygonSymbolizer | Fill + Stroke | fill、fill-opacity、面边界描边参数 |
Mark 的 WellKnownName 常用 circle、square、triangle、star、cross、x,默认多为 square。面样式先填充再描边;面内孔洞一般只描边不填充。线样式只有描边,没有填充。更细的语法说明见官方 SLD Reference,本站也有 GeoServer SLD 样式文件、制作工具和点样式说明 可对照。

在 GeoServer 里添加并绑定样式
先确认运行环境:GeoServer 3.0.x / 2.28.x 最低需要 Java 17,推荐 OpenJDK,并按官方容器要求部署。样式本身不依赖特定前端框架,但图层 CRS、几何类型和字段名必须正确,否则预览空白或错位。
- 打开 Web 管理界面,进入 Data → Styles → Add a new style。
- 填写样式名称;可粘贴 XML、上传 .sld,或生成 Point / Line / Polygon / Raster / Generic 默认模板,也可从现有样式复制。
- 点 Validate 检查 XML 是否合法、命名空间是否齐全(通常含 http://www.opengis.net/sld 等),通过后 Save。
- 进入 Layers 选择目标图层 → Publishing,把 Default Style(或 Available Styles)设为刚保存的样式。
- 用 Layer Preview(OpenLayers 等)平移缩放复核;改样式后刷新预览即可,不必重建数据源。
若同一图层含混合几何,不要指望一个简单 Symbolizer 覆盖全部,需按过滤条件拆 Rule,或参考官方混合几何写法。样式编写与编辑器选择可参考 GeoServer SLD 样式怎么写及编辑工具 和 GeoServer 样式写法与 SLD 编辑器位置。
点线面配置要点与可执行写法
写 SLD 时先固定最小样例图层,再扩到全量。三类样式的实操要点如下。
- 点样式:在 PointSymbolizer 中放 Graphic;用 Mark 做矢量符号,或用 ExternalGraphic 引用 PNG/SVG(路径相对 styles 目录或可用 URL)。用 Size、Opacity、Rotation 控制大小与朝向;CssParameter 设置填充色和描边。
- 线样式:LineSymbolizer 必须有 Stroke。用 stroke、stroke-width、stroke-opacity 控制外观;虚线用 stroke-dasharray;需要沿线偏移时可用 PerpendicularOffset(厂商扩展,正负方向相反)。
- 面样式:PolygonSymbolizer 同时配置 Fill 与 Stroke。Fill 可用纯色或 GraphicFill;边界描边写法与线一致。不要把面填充参数写进线样式,也不要省略面边界若项目要求压盖清晰。
- 规则与比例尺:多个 Rule 可按 Filter 分流属性,用 Min/MaxScaleDenominator 控制不同比例可见性,避免小比例尺符号过密。
- 几何字段:默认用图层主几何;多几何列时用 Geometry 元素显式指定,否则样式可能作用到错误字段。

验收时至少核对:预览中符号类型正确、颜色与线宽符合设计、指定比例尺下显示/隐藏符合 Rule、属性过滤后要素数量与桌面 GIS 抽查一致。把通过验证的 SLD 存成项目模板,图层发布时直接复用。
常见报错与排查顺序
样式问题看起来像“地图空白”,根因常在 XML、几何类型或绑定环节。建议按下面顺序排查:
- Validate 是否报命名空间、标签拼写或未闭合错误;先修到能保存。
- 图层几何类型是否与 Symbolizer 匹配(点图层误用面样式、或混合几何未拆 Rule)。
- Publishing 是否真正绑定了新样式;缓存或浏览器旧瓦片会导致“改了看不见”,先清缓存再预览。
- ExternalGraphic 路径、权限或 MIME 是否可读;Mark 的 WellKnownName 是否写错。
- Filter 字段名、类型是否与属性表一致;表达式算错会导致整类要素被滤掉。
- 不要一次改多个参数;每次只改颜色、线宽或 Size 之一,便于回滚。
- 不要把临时预览当成已发布结果;确认 Default Style 已保存后再交付。
- 坐标系错误会表现为整体偏移,那是数据/CRS 问题,不是 Symbolizer 参数问题。
常见问题
点线面必须写成三个独立 SLD 吗?
不是必须。一个图层一种主几何时,一个 SLD 即可;同一工作区可维护 point/line/polygon 三套通用样式再分别绑定。混合几何图层则应在同一 SLD 里用多条 Rule 分流,而不是硬套单一 Symbolizer。
改完 SLD 预览还是旧样式怎么办?
先确认 Styles 已 Save,且图层 Publishing 的 Default Style 指向新名称。再清 GeoWebCache 相关缓存并强制刷新浏览器。若用外部 SLD_BODY/SLD URL,还要检查请求是否仍指向旧文件。
GeoServer 3.x 和 2.28 的 SLD 写法差很多吗?
点线面基础 Symbolizer 与 SLD 1.0.0 结构仍然通用。差异主要在运行环境(Java、容器版本)和部分扩展能力。新项目优先用当前 Stable;维护旧系统时以你正在运行的文档版本为准,不要混用过期示例路径。
怎样判断样式已经配成功?
Layer Preview 中抽查已知坐标点的符号形状、颜色、线宽;切换比例尺验证 ScaleDenominator;对带 Filter 的 Rule 核对要素数量。三项都与设计稿或桌面制图一致,即可认为点线面样式配置通过。
GeoServer 的 SLD 点线面配置,核心是选对 Symbolizer、写清 Fill/Stroke/Graphic,并在 Styles 与图层 Publishing 两端正确绑定。建议先用最小样例图层把一类几何跑通,再沉淀成可复用模板;需要系统学习写法与工具时,优先结合本站已有 SLD 教程按步骤落地,而不是在完整项目上同时改数据和样式。