GeoServer REST API POST添加远程栅格图层报错求助

尝试通过GeoServer REST API的POST方法添加远程栅格图层，请求地址：

http://192.168.8.134:8080/geoserver/rest/workspaces/myWorkSpace/coveragestores/myCoverage/remote.geotiff

请求体内容为FTP地址：

ftp://user:password@192.168.8.200/MapFile/1.tif

但GeoServer返回错误提示无法创建阅读器（输入参数为null），服务器日志显示Argument "input" should not be null，定位到CoverageStoreFileController.java第98行调用info.getGridCoverageReader(null, null)时出错。已知PUT方法可正常操作但不支持远程方式，寻求解决办法。

1. 修正POST请求的端点与格式 #

你当前使用的/remote.geotiff端点设计用于上传本地文件内容，而非提交远程URL。正确的做法是POST到覆盖存储的根端点，用XML或JSON格式定义存储配置：

XML请求示例

请求地址：

http://192.168.8.134:8080/geoserver/rest/workspaces/myWorkSpace/coveragestores

请求头：Content-Type: application/xml
请求体：

<coverageStore>
  <name>myCoverage</name>
  <type>GeoTIFF</type>
  <enabled>true</enabled>
  <url>ftp://user:password@192.168.8.200/MapFile/1.tif</url>
</coverageStore>

JSON请求示例

请求地址同上，请求头：Content-Type: application/json
请求体：

{
  "coverageStore": {
    "name": "myCoverage",
    "type": "GeoTIFF",
    "enabled": true,
    "url": "ftp://user:password@192.168.8.200/MapFile/1.tif"
  }
}

2. 验证请求头配置 #

确保POST请求的Content-Type与请求体格式匹配（XML对应application/xml，JSON对应application/json），避免因格式解析失败导致URL未被正确识别。

3. 检查FTP访问可行性 #

• 在GeoServer所在服务器上，手动测试FTP连接：执行ftp 192.168.8.200，输入用户名密码后尝试读取/MapFile/1.tif，确认文件可访问
• 排查网络连通性：确保GeoServer服务器与FTP服务器之间无防火墙、路由规则阻挡，端口21（默认FTP端口）开放

4. 排查GeoServer扩展与版本 #

• 确认GeoServer已安装GeoTIFF扩展：检查WEB-INF/lib目录下是否存在gt-geotiff-*.jar文件（通常默认包含）
• 若使用旧版本GeoServer（如2.20以下），建议升级到稳定版（如2.24.x），部分旧版本对远程覆盖存储的REST API支持存在bug

内容的提问来源于stack exchange，提问作者miniboxHaHa