Bug: MapBoxTileBuilder Cannot obtain numeric id from featureId

dcalde · February 19, 2026, 3:06pm

I wasn’t able to report on Jira, so trying here.

We noticed lots of these warning in the logs regarding our feature ids even though we use valid BIGINT.

WARN [wms.mapbox] - Cannot obtain numeric id from featureId

I was able to identify the source of the issue:

github.com/geoserver/geoserver

src/extension/vectortiles/src/main/java/org/geoserver/wms/mapbox/MapBoxTileBuilder.java

main


      
          @Override
          public void addFeature(
                  String layerName,
                  String featureId,
                  String geometryName,
                  Geometry geometry,
                  Map<String, Object> properties) {
              int id = -1;
              if (featureId.matches(".*\\.[0-9]+")) {
                  try {
                      id = Integer.parseInt(featureId.split("\\.")[1]);
                  } catch (NumberFormatException e) {
                  }
              }
          
              if (id < 0) {
                  LOGGER.warning("Cannot obtain numeric id from featureId: " + featureId);
              }
          
              encoder.addFeature(layerName, properties, geometry, id);
          }

The code should be parsing the feature id into long rather than int matching the method signature of the VectorTileEncode.addFeature

github.com/ElectronicChartCentre/java-vector-tile

src/main/java/no/ecc/vectortile/VectorTileEncoder.java

master


      
           * 256,256 lower right.
           * <p>
           * For optimization, geometries will be clipped and simplified. Features with
           * geometries outside of the tile will be skipped.
           *
           * @param layerName a {@link String} with the vector tile layer name.
           * @param attributes a {@link Map} with the vector tile feature attributes.
           * @param geometry a {@link Geometry} for the vector tile feature.
           * @param id a long with the vector tile feature id field.
           */
          public void addFeature(String layerName, Map<String, ?> attributes, Geometry geometry, long id) {
          
              // skip small Polygon/LineString.
              if (geometry instanceof MultiPolygon && geometry.getArea() < minimumArea) {
                  return;
              }
              if (geometry instanceof Polygon && geometry.getArea() < minimumArea) {
                  return;
              }
              if (geometry instanceof LineString && geometry.getLength() < minimumLength) {
                  return;

This is inline with the Vector Tile Spec which specifies uint64:

github.com/mapbox/vector-tile-spec

2.1/vector_tile.proto

master


      
                  optional int64 int_value = 4;
                  optional uint64 uint_value = 5;
                  optional sint64 sint_value = 6;
                  optional bool bool_value = 7;
          
                  extensions 8 to max;
          }
          
          // Features are described in section 4.2 of the specification
          message Feature {
                  optional uint64 id = 1 [ default = 0 ];
          
                  // Tags of this feature are encoded as repeated pairs of
                  // integers.
                  // A detailed description of tags is located in sections
                  // 4.2 and 4.4 of the specification
                  repeated uint32 tags = 2 [ packed = true ];
          
                  // The type of geometry stored in this feature.
                  optional GeomType type = 3 [ default = UNKNOWN ];