GeoServer 2.19.2创建ImageMosaic时shx文件未生成图层预览无内容

1. SMB共享目录的文件写入同步与锁机制和本地文件系统存在差异：GeoTools生成Shapefile索引时按shp→shx→dbf的顺序写入，过程中需要多次调用文件系统flush、锁释放操作。Windows SMB共享的默认锁策略会延迟远程文件的写入提交，当GeoTools认为写入完成释放进程资源时，shx文件的写入操作还未被SMB服务端落地，最终导致shx文件丢失。
2. 版本兼容性bug：GeoServer 2.19.2依赖的GeoTools 25.x版本存在ImageMosaic远程路径写入兼容问题，当索引存储路径为SMB等远程挂载路径时，shx文件的输出流未被正确关闭刷入，仅生成shp和properties文件。
3. 挂载参数隐性限制：若Linux挂载SMB时未正确配置权限、锁相关参数，即使显示tomcat用户拥有rwx权限，也可能出现特定后缀文件写入被拦截的情况。

• 验证本地路径写入兼容性：将少量测试GeoTiff复制到Ubuntu本地tomcat可读写目录，创建ImageMosaic确认是否能正常生成shp、shx、dbf三个索引文件，若本地生成正常即可判定为SMB共享路径问题。
• 检查SMB挂载参数：执行mount | grep cifs查看当前共享目录的挂载参数，确认是否包含nobrl（不发送字节范围锁）、cache=none（关闭缓存）参数，缺失上述参数大概率会触发写入缓存/锁冲突。
• 排查日志WARN级别输出：重点检索GeoServer日志中ShapefileDataStore相关的警告记录，shx写入失败的IO异常通常被标记为WARN而非ERROR，易被忽略。

临时适配方案（适用测试环境） #

1. 本地生成索引后迁移：先在Ubuntu本地目录创建ImageMosaic，生成完整的shp、shx、dbf、properties文件后，将所有索引文件和GeoTiff一同移动到SMB共享目录，调整properties文件中的路径配置匹配共享目录路径即可使用。
2. 调整SMB挂载参数：重新挂载共享目录时添加锁、缓存兼容参数，参考挂载命令：

mount -t cifs //<Windows_IP>/<共享名> /<本地挂载路径> -o username=<共享账号>,password=<共享密码>,uid=<tomcat用户UID>,gid=<tomcat用户GID>,file_mode=0777,dir_mode=0777,nobrl,cache=none

挂载完成后重新创建ImageMosaic即可正常生成shx文件。

永久解决方案 #

1. 版本升级：将GeoServer升级到2.20.x及以上版本，对应版本的GeoTools已修复远程路径下ImageMosaic索引写入不完整的bug。
2. 手动生成索引：若必须保留2.19.2版本，可使用GDAL工具提前生成索引文件，参考命令：

gdaltindex index.shp /path/to/tiffs/*.tif

生成完整的shp/shx/dbf索引后，在GeoServer创建ImageMosaic时选择已有的索引文件即可，无需触发自动生成逻辑。

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