使用GeoServer Rest API创建FeatureType触发空指针异常求助

问题定位 #

从日志的NullPointerException堆栈来看，异常发生在FeatureTypeValidator.validate方法中，核心原因是要素类型（FeatureType）的必填元数据缺失，或DataStore配置存在问题导致GeoServer无法读取Shapefile的元信息。

解决方案步骤 #

1. 修正DataStore的nativeName配置

创建DataStore时，nativeName需设置为Shapefile的主文件名（不含.shp后缀），GeoServer会自动关联同目录下的.dbf/.prj/.shx等附属文件：

{
    "dataStore": {
        "workspace": "test",
        "enabled": true,
        "name": "gis_osm_adminareas_a_07_1",
        "nativeName": "gis_osm_adminareas_a_07_1", // 移除.shp后缀
        "connectionParameters": {
            "entry": [
                { "@key": "filetype", "$": "shapefile" },
                { "@key": "create spatial index", "$": "true" },
                { "@key": "url", "$": "file:///geoserver/uploads/6b82db8f-427c-4f07-9c89-e95ae6413732/gis_osm_adminareas_a_07_1.shp" },
                { "@key": "enable spatial index", "$": "true" },
                { "@key": "charset", "$": "ISO-8859-1" },
                { "@key": "memory mapped buffer", "$": "false" },
                { "@key": "timezone", "$": "GMT" },
                { "@key": "namespace", "$": "http://test" },
                { "@key": "cache and reuse memory maps", "$": "false" },
                { "@key": "fstype", "$": "shape" }
            ]
        },
        "type": "Shapefile"
    }
}

2. 简化FeatureType请求Body，避免手动指定属性

手动编写attributes极易出现类型不匹配或字段遗漏，建议让GeoServer自动从Shapefile读取元数据，仅传递核心必填字段：

{
    "featureType": {
        "name": "gis_osm_adminareas_a_07_1",
        "title": "gis_osm_adminareas_a_07_1",
        "enabled": true,
        "store": {
            "@class": "dataStore",
            "name": "test:gis_osm_adminareas_a_07_1"
        },
        "srs": "EPSG:4326" // 替换为Shapefile对应的实际坐标系编码
    }
}

若必须手动指定attributes，需确保几何字段添加nativeType，且所有属性的binding与Shapefile实际类型完全匹配：

{
    "name": "the_geom",
    "minOccurs": 0,
    "maxOccurs": 1,
    "nillable": true,
    "binding": "org.locationtech.jts.geom.MultiPolygon",
    "nativeType": "MultiPolygon" // 新增该字段匹配Shapefile几何类型
}

3. 检查请求头与认证

确保请求携带正确的头信息：

• Content-Type: application/json
• 有效的身份认证（如Basic Auth），确保账号拥有WorkspaceModify和DataStoreModify权限

补充说明 #

Web面板创建图层时，GeoServer会自动完成以下操作：

• 从.prj文件读取坐标系信息
• 自动解析所有属性的类型和长度
• 填充要素类型的完整元数据
  而REST API请求需显式提供必填元数据，或允许GeoServer自动解析，否则会触发Validator校验时的空指针异常。

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