GEE数据导出报错(Error code:3)：Image.clipToBoundsAndScale类型不匹配求助

错误信息明确指出：Image.clipToBoundsAndScale 方法的 input 参数类型不合法——要求输入影像（Image），但实际传入了要素集合（FeatureCollection），这是典型的类型不匹配问题。

场景1：误将矢量边界直接传给裁剪方法 #

很多人会错把用于裁剪的边界（FeatureCollection）当成输入传给clipToBoundsAndScale，但这个方法的第一个参数必须是要裁剪的目标影像。

错误示例：

var roi = ee.FeatureCollection("users/xxx/your-roi");
Export.image.toDrive({
  image: ee.Image.clipToBoundsAndScale(roi, ...), // 错误：把FeatureCollection作为input传入
  // 其他导出参数
});

修复方法：
先获取要导出的影像，再调用clipToBoundsAndScale，将影像作为第一个参数，边界作为后续参数传入：

var roi = ee.FeatureCollection("users/xxx/your-roi");
var targetImage = ee.Image("LANDSAT/LC08/C02/T1_TOA/LC08_123032_20230101"); // 示例影像

// 正确用法：第一个参数是影像，后续传入边界、缩放等参数
var clippedImage = targetImage.clipToBoundsAndScale({
  geometry: roi,
  scale: 30
});

Export.image.toDrive({
  image: clippedImage,
  description: "export_clipped_image",
  region: roi,
  scale: 30,
  maxPixels: 1e13
});

场景2：变量赋值错误，混淆影像与矢量集合 #

如果原本想加载影像，却误加载了矢量数据集，或者变量名混用，会导致调用裁剪方法时传入错误类型。

错误示例：

// 错误：把FeatureCollection赋值给了本应存储Image的变量
var myImage = ee.FeatureCollection("users/xxx/your-roi"); 
var clipped = myImage.clipToBoundsAndScale(...); // 类型不匹配报错

修复方法：
检查变量赋值逻辑，确保调用clipToBoundsAndScale的主体是Image类型对象：

// 确认加载的是影像
var myImage = ee.Image("LANDSAT/LC08/C02/T1_TOA/LC08_123032_20230101"); 
var roi = ee.FeatureCollection("users/xxx/your-roi");
var clipped = myImage.clipToBoundsAndScale({
  geometry: roi,
  scale: 30
});

场景3：直接对影像集合（ImageCollection）调用裁剪方法 #

如果处理的是ImageCollection，直接调用clipToBoundsAndScale会报错，因为ImageCollection不是单个Image对象。

错误示例：

var imgCol = ee.ImageCollection("LANDSAT/LC08/C02/T1_TOA").filterDate("2023-01-01", "2023-02-01");
var clipped = imgCol.clipToBoundsAndScale(roi, 30); // 错误：ImageCollection不是Image

修复方法：
先将ImageCollection转换为单幅Image（比如用first()取首幅影像，或mean()/median()生成合成影像）：

var imgCol = ee.ImageCollection("LANDSAT/LC08/C02/T1_TOA").filterDate("2023-01-01", "2023-02-01");
var singleImage = imgCol.mean(); // 生成时间序列合成影像
var clipped = singleImage.clipToBoundsAndScale({
  geometry: roi,
  scale: 30
});

• Image.clipToBoundsAndScale() 是Image类的专属方法，必须由Image对象调用，或第一个参数传入Image。
• 如果仅需基础裁剪，也可以用更简洁的image.clip(roi)方法，再配合Export参数设置缩放比例和导出区域。

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