如何避免远程图层返回空响应时的MapServer报错

问题描述 #

我的MapServer图层从参数化Web服务获取GeoJSON要素（由聚合点生成的多边形），每个要素包含num_points属性，用于按点数区间设置不同的显示颜色。但当Web服务返回无要素的响应时，MapServer会抛出以下错误：

msOGRLayerInitItemInfo(): OGR error. Invalid Field name: num_points in layer COLLECTION_POINTS

对应的mapfile配置如下：

LAYER
  NAME "COLLECTION_POINTS"
  TYPE POLYGON
  CONNECTIONTYPE OGR

  VALIDATION
    "col" "^[0-9]+$"
  END

  CONNECTION "http://myservice/%col%/agg_points"
  DATA "agg_points"

  # [snip metadata and projection stuff]

  CLASS
    NAME "<= 100 pts"
    EXPRESSION ([num_points] < 101)
    STYLE
      COLOR "#D88A01"
      OUTLINECOLOR "#D88A01"
    END
  END
  CLASS
    NAME "<= 500 pts"
    EXPRESSION ([num_points] < 501)
    STYLE
      COLOR "#EA8015"
      OUTLINECOLOR "#EA8015"
    END
  END
  CLASS
    NAME "> 500 pts"
    EXPRESSION ([num_points] > 500)
    STYLE
      COLOR "#BC2110"
      OUTLINECOLOR "#BC2110"
    END
  END
END

可行解决方案 #

1. 在类表达式中先检查字段是否存在 #

MapServer支持HASATTR()函数判断字段是否存在，修改每个类的表达式，先验证字段存在再进行数值判断，同时可以添加默认类处理无字段的情况：

CLASS
  NAME "<= 100 pts"
  EXPRESSION (HASATTR('num_points') AND [num_points] < 101)
  STYLE
    COLOR "#D88A01"
    OUTLINECOLOR "#D88A01"
  END
END
CLASS
  NAME "101-500 pts"
  EXPRESSION (HASATTR('num_points') AND [num_points] > 100 AND [num_points] < 501)
  STYLE
    COLOR "#EA8015"
    OUTLINECOLOR "#EA8015"
  END
END
CLASS
  NAME "> 500 pts"
  EXPRESSION (HASATTR('num_points') AND [num_points] > 500)
  STYLE
    COLOR "#BC2110"
    OUTLINECOLOR "#BC2110"
  END
END
# 处理无num_points字段的情况（无数据时不渲染）
CLASS
  NAME "No data"
  EXPRESSION (NOT HASATTR('num_points'))
  STYLE
    SYMBOL "none"
  END
END

2. 预定义图层字段 #

在LAYER块中添加ITEMS或ATTRIBUTES配置，强制MapServer识别num_points字段，即使服务返回无要素：

LAYER
  NAME "COLLECTION_POINTS"
  TYPE POLYGON
  CONNECTIONTYPE OGR

  VALIDATION
    "col" "^[0-9]+$"
  END

  CONNECTION "http://myservice/%col%/agg_points"
  DATA "agg_points"

  # 预定义字段，避免无要素时的字段校验错误
  ITEMS "num_points"
  # 可选：用ATTRIBUTES明确字段类型
  ATTRIBUTES
    num_points INTEGER
  END

  # [snip metadata and projection stuff]

  # 原有类配置...
END

该方法让MapServer提前知晓字段定义，跳过动态获取字段时的错误校验。

3. 客户端侧处理错误响应 #

如果服务端配置无法完全解决问题，可以调整客户端逻辑：

• 捕获MapServer的500错误响应
• 解析响应内容，判断是否为num_points字段不存在的特定错误
• 客户端渲染空图层或显示“当前无数据”的提示信息

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