使用GTRenderer渲染OSM瓦片返回空白图问题排查

从你遇到的情况和日志信息来看，问题的核心是GeoTools TileLayer的默认瓦片加载数量限制导致的空白图片。

为什么会出现空白？ #

日志里的[pool-2-thread-1] org.geotools.tile Reached tile limit of 128. Returning an empty collection.是关键提示：GeoTools的TileLayer默认设置了最多加载128个瓦片的限制。当你要渲染的区域范围较大时，需要的瓦片数量超过这个阈值，TileLayer就会返回空的瓦片集合，自然渲染出来就是空白图。

而WMS图层是由服务器端完成渲染后返回整幅图像，不存在客户端的瓦片数量限制，所以你的saveImage方法处理WMS时正常。另外你能成功加载单个瓦片，也说明OSM服务本身是正常的，只是批量加载时触发了数量限制。

解决步骤 #

1. 调整TileLayer的瓦片加载上限

在创建TileLayer后，调用setTileLoadingLimit()方法设置一个更大的阈值，具体数值可以根据你要渲染的区域大小来调整（比如512、1024等）：

MapContent map = new MapContent();
String baseURL = "http://<url>"; // OSM url
TileService service = new OSMService("OSM", baseURL);
TileLayer tileLayer = new TileLayer(service);
// 新增：调整瓦片加载上限
tileLayer.setTileLoadingLimit(512); 
map.addLayer(tileLayer);

2. 确认渲染范围的坐标系匹配

OSM瓦片使用的是Web Mercator坐标系（EPSG:3857），请确保你传入saveImage方法的ReferencedEnvelope envelope的坐标系也是EPSG:3857。如果你的原始范围是其他坐标系（比如WGS84，EPSG:4326），需要先进行转换：

// 示例：将WGS84的范围转换为Web Mercator
CoordinateReferenceSystem sourceCRS = CRS.decode("EPSG:4326");
CoordinateReferenceSystem targetCRS = CRS.decode("EPSG:3857");
ReferencedEnvelope transformedEnvelope = originalEnvelope.transform(targetCRS, true);
// 用转换后的范围调用saveImage
saveImage(map, file, transformedEnvelope, imageWidth, formatName);

验证调整效果 #

修改后再运行代码，日志里的Reached tile limit提示应该会消失，渲染出来的图片也会正常显示OSM瓦片内容。

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