ArcGIS升级至3.2+版本后FeatureLayer无法显示问题咨询

该版本兼容问题属于ArcGIS JS API 3.x跨小版本升级的常见问题，大量开发者升级时都遇到过，核心是3.18到3.2+版本的几个不兼容变更导致，对应解决方式如下：

FeatureLayer 无法加载的核心原因 #

• 3.2版本起FeatureLayer新增服务能力字段校验，对接10.2及更早版本的ArcGIS Server时，服务返回的元数据缺少supportsPagination、supportsCoordinatesQuantization等高版本新增字段，会导致图层静默初始化失败，无明显前台报错。
• MODE_ONDEMAND模式默认请求参数变更：3.18及之前版本按需模式默认不传outFields、outSR参数，3.2+版本默认参数会触发老版本服务的动态投影校验、字段权限校验，直接返回空要素集。
• 跨域规则调整：3.2版本修改了IO模块的CORS检测逻辑，未在corsEnabledServers列表中配置的服务域名，FeatureLayer的query请求会被拦截，而ArcGISDynamicMapServiceLayer走图片导出接口，跨域校验逻辑更宽松，因此可以正常出图。

FeatureLayer 兼容修复代码 #

初始化图层时显式声明兼容参数，覆盖默认的高版本逻辑即可：

// 提前配置服务域名跨域白名单
esriConfig.defaults.io.corsEnabledServers.push("你的服务部署域名");

var fLayer = new FeatureLayer("https://..../MapServer/0", {
  mode: FeatureLayer.MODE_ONDEMAND,
  outFields: ["*"], // 显式声明返回字段，3.2+不再默认返回全字段
  outSpatialReference: map.spatialReference, // 显式指定返回空间参考，匹配当前地图
  capabilities: "Map,Query,Data", // 手动声明图层能力，跳过服务元数据校验
  disableClientCaching: true // 关闭旧版本缓存干扰
});
// 绑定错误监听方便定位剩余问题
fLayer.on("error", e => console.error("FeatureLayer加载异常：", e));
map.addLayer(fLayer);

如果对接的是10.0/10.1这类极老版本服务，建议直接升级API到3.44（3.x最终稳定版），官方已经在该版本补全了老服务的降级兼容逻辑，不需要额外加参数。

ArcGISDynamicMapServiceLayer 弹窗不生效修复 #

3.2版本废弃了动态服务默认的点击识别弹窗逻辑，直接绑定infoTemplate不会触发弹窗，需要手动绑定点击事件执行Identify查询：

const dynamicLayer = new ArcGISDynamicMapServiceLayer("https://..../MapServer");
map.addLayer(dynamicLayer);

map.on("click", evt => {
  const identifyTask = new IdentifyTask(dynamicLayer.url);
  const params = new IdentifyParameters();
  params.geometry = evt.mapPoint;
  params.mapExtent = map.extent;
  params.tolerance = 3;
  params.layerIds = [0]; // 指定要查询的图层ID
  params.layerOption = IdentifyParameters.LAYER_OPTION_VISIBLE;
  params.width = map.width;
  params.height = map.height;
  params.returnGeometry = false;

  identifyTask.execute(params, res => {
    if (!res.length) {
      map.infoWindow.hide();
      return;
    }
    // 自定义弹窗内容拼接逻辑
    const attr = res[0].feature.attributes;
    const content = `<div>图层属性：${JSON.stringify(attr)}</div>`;
    map.infoWindow.setContent(content);
    map.infoWindow.show(evt.mapPoint);
  });
});

避坑提示：3.2到3.21区间的版本存在较多兼容问题，非必要不要锁定这部分版本号，3.x分支直接选3.44版本稳定性最高。

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