GeoServer REST API创建同目录时间维度ImageMosaic未生成Coverage图层

先检查Coverage Store的创建参数 #

• 确认创建命令里的url指向的是包含ImageMosaic配置文件的目录，不是单个影像文件。正确的curl命令示例：

  curl -u admin:geoserver -XPOST -H "Content-type: application/json" \
  http://localhost:8080/geoserver/rest/workspaces/your_workspace/coveragestores \
  -d '{
    "coverageStore": {
      "name": "your_store",
      "type": "ImageMosaic",
      "enabled": true,
      "url": "file:///path/to/your/mosaic_config_dir"
    }
  }'
  

• 这个目录里必须有indexer.properties、timeregex.properties这些核心配置文件，不然GeoServer没法识别时间维度和影像集合。

验证ImageMosaic配置文件正确性 #

• indexer.properties里要明确时间维度配置，比如：

  TimeAttribute=time
  Schema=*the_geom:Polygon,location:String,time:java.util.Date
  PropertyCollectors=TimestampFileNameExtractorSPI[timeregex](time)
  

• timeregex.properties的正则必须匹配你的影像文件名时间格式，比如文件名是img_20240520.tif，正则就写：

  regex=img_([0-9]{8})
  

• 确保目录里的所有影像文件名都符合这个正则，不然GeoServer提取不到时间信息，没法生成图层。

显式发布图层的curl命令 #

创建完Coverage Store后，得主动触发图层发布，不能等自动生成。命令示例：

curl -u admin:geoserver -XPOST -H "Content-type: application/json" \
http://localhost:8080/geoserver/rest/workspaces/your_workspace/coveragestores/your_store/coverages \
-d '{
  "coverage": {
    "name": "your_layer",
    "title": "Time-enabled Image Mosaic",
    "enabled": true,
    "metadata": {
      "time": {
        "enabled": true,
        "presentation": "LIST",
        "units": "ISO8601"
      }
    }
  }'

• 把your_workspace、your_store、your_layer换成你实际的名称。

查日志找具体问题 #

• 打开GeoServer的logs/geoserver.log，搜ImageMosaic、coverage或者错误关键词：
  • 要是出现文件找不到的错误，检查url里的路径是不是绝对路径，GeoServer进程有没有访问该目录的权限。
  • 要是出现时间解析错误，核对timeregex.properties和文件名的匹配度。
  • 要是有权限报错，给影像目录加GeoServer进程的读写权限。

先手动UI测试排除配置问题 #

• 先通过GeoServer后台UI手动创建这个ImageMosaic图层，要是UI能成功，就对比手动配置和REST命令的参数，看看REST请求里漏了什么配置项。

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