QGIS 连接 GeoServer 全流程指南：WebGIS 服务搭建

适用场景：需高效发布大量矢量/栅格数据，并保留 QGIS 符号化样式。

1. 插件安装：
   • QGIS 菜单栏 → 插件 → 管理并安装插件 → 搜索 GeoCat Bridge → 安装。
   • 安装后工具栏出现 Publish 按钮。
2. 配置 GeoServer 连接：
   • 点击 Publish 按钮 → 左侧 Servers 标签 → New Server。
   • 填写参数：
     • 连接名：自定义（如 LocalGeoServer）。
     • URL：http://localhost:8080/geoserver。
     • 存储方式：选择 File-based storage（数据上传至 GeoServer 目录）或 PostGIS（直接写入数据库）。
     • 认证：添加 GeoServer 用户名密码。
3. 批量发布数据：
   • 在 QGIS 中加载需发布的图层（如 Shapefile、GeoJSON）。
   • 对图层进行符号化（如按属性分类设色）。
   • 保存 QGIS 工程（工程名将作为 GeoServer 工作区名，需确保唯一）。
   • 点击 Publish 按钮 → 选择目标服务器 → 发布。

关键注意事项：

• 工作区冲突：若工程名与 GeoServer 现有工作区重复，会覆盖原有数据。
• 坐标系：确保 QGIS 工程与 GeoServer 坐标系一致（如 EPSG:4326）。
• 数据类型：矢量数据默认发布为 GeoPackage 格式，栅格为 GeoTIFF。

方式三：手动发布 QGIS 编辑的 SLD 样式

适用场景：需精细控制 GeoServer 图层样式，或复用 QGIS 的复杂符号化规则。

1. 在 QGIS 中导出 SLD 文件：
   • 右键图层 → 属性 → 样式 → 底部 Style 下拉菜单 → Save Style → 选择 SLD File。
   • 示例 SLD 片段（河流线样式）：

<StyledLayerDescriptor>
  <UserStyle>
    <Name>rivers_style</Name>
    <FeatureTypeStyle>
      <Rule>
        <LineSymbolizer>
          <Stroke>
            <CssParameter name="stroke">#1E90FF</CssParameter>
            <CssParameter name="stroke-width">2</CssParameter>
          </Stroke>
        </LineSymbolizer>
      </Rule>
    </FeatureTypeStyle>
  </UserStyle>
</StyledLayerDescriptor>

2. 在 GeoServer 中应用 SLD：
   • 登录 GeoServer → Styles → Add new style → 上传 SLD 文件。
   • 发布图层时，在 Publish 页面 → Default Style 下拉菜单中选择对应样式。

进阶技巧：

• 动态样式：通过 SLD 的 Filter 实现按比例尺或属性动态显示（如不同宽度河流）。
• 比例尺控制：在 SLD 中添加 MinScaleDenominator 和 MaxScaleDenominator 参数。

三、常见问题与解决方案

问题 1：QGIS 无法连接 GeoServer（连接超时或 404 错误）

• 排查步骤：
  1. 检查 GeoServer 服务是否运行：访问 http://localhost:8080/geoserver/web。
  2. 确认 URL 格式：确保末尾为 /wms（WMS 服务）或 /wfs（WFS 服务）。
  3. 防火墙设置：关闭防火墙或放行 8080 端口。

问题 2：发布的图层在 QGIS 中显示为空白

• 可能原因：
  • 坐标系不匹配：检查 QGIS 工程坐标系与 GeoServer 图层 SRS 设置。
  • 数据范围问题：在 GeoServer Layer Preview 中确认图层是否有数据返回。
  • 样式错误：尝试更换为 GeoServer 默认样式测试。

问题 3：GeoCat Bridge 发布失败（工作区创建错误）

• 解决方案：
  1. 确保 QGIS 工程名不含特殊字符或空格。
  2. 手动删除 GeoServer 中同名工作区（通过 Workspaces 页面）。
  3. 检查数据存储路径权限（确保 Tomcat 用户有写入权限）。

四、性能优化建议

1. 瓦片缓存：在 GeoServer 中配置 GeoWebCache，缓存常用比例尺的瓦片。
2. 数据分块：对大型栅格数据使用 ImageMosaic 或分块存储。
3. 并发控制：调整 GeoServer 的 JAI 和 JAI-ImageIO 内存参数（如 -Xmx4G）。

五、总结与扩展

通过本教程，您已掌握 QGIS 与 GeoServer 的三种核心连接方式：

1. WMS/WMTS 调用：适合快速集成现有服务。
2. GeoCat Bridge 插件：高效批量发布数据并保留样式。
3. SLD 手动同步：实现复杂符号化的精准控制。

下一步学习方向：

• 结合 OpenLayers 或 Leaflet 开发前端地图应用。
• 探索 GeoServer 的 WPS（Web Processing Service）实现空间分析。
• 使用 PostGIS 进行空间数据库优化与查询。

参考资料：

• GeoServer 官方文档
• QGIS 培训手册
• GeoCat Bridge 插件文档