一、SuperMap iServer

问题1：iServer服务经Nginx代理，有访问权限的地图显示空白，但通过图片URL访问可正常出图

11.3.0
【解决办法】重启iServer且清空浏览器缓存后，再访问。

问题2：32核509GB服务器可以支撑多少个服务实例？

11.3.0
【解决办法】无固定值，取决于资源消耗。常规地图服务约1000个，建议通过监控和压测验证实际承载能力。

问题3：同一数据源分类切片后的数据，发布成地图服务后叠加存在偏移。

11.3.0

【问题原因】iServer 地图缓存导致
【解决办法】清空iServer缓存，重访问即可

问题4：iServer服务SQL属性查询只返回20条，如何返回全部？

11.3.0

【解决办法】使用fromIndex和toIndex参数控制返回数量。具体参考https://iclient.supermap.io/web/apis/leaflet.html

问题5：iServer页面变成接口名，报错servicesLabel.rjson与资源URL不匹配。

11.0.0

【问题原因】本地存有iServer 12的缓存，与11版本冲突。 【解决办法】清理浏览器缓存。

问题6：iServer 11i更换许可后，前端页面一直显示未检测到许可。已在opt下创建SuperMap和License文件夹。

11.1.0
【问题原因】12i的iServer申请的11i的许可
【解决办法】重新申请12i的许可后正常

问题7：将iServer由HTTP协议改为HTTPS，如何修改配置？修改后对渲染速度、现有服务或前端渲染是否有影响？

11.1.0
【解决办法】修改协议不会影响前端渲染，具体修改方式参考官方帮助文档：https://help.supermap.com/iServer/zh/Subject_introduce/Security/systemSecurity/HTTPS/HTTPS.htm

问题8：iServer协议由HTTP改为HTTPS启动失败，利用备份还原启动也失败。

11.0.1

【问题原因】iServer进程未完全关闭。 【解决办法】需确保iServer完全停止后再启动。Linux通过ps -ef| grep iserver找到进程并kill -9 pid；Windows通过任务管理器结束进程。

问题9：原始地图坐标系为WGS84（4326），发布为动态地图服务后，当客户端使用Web Mercator（3857）坐标系请求加载时，地图上的点符号样式发生改变。

11.3.0

【解决办法】替换成双周包后没有出现，https://pan.baidu.com/s/1xbv6s5vlbqw_uMg9J9hgJw?pwd=6655#list/path=%2Fsharelink4065445437-1054164313423659%2FiServer%26iEdge%2FiServer%2F11.3.0%2F2025M8-1%EF%BC%88%E6%96%B0%EF%BC%89&parentPath=%2Fsharelink4065445437-1054164313423659

问题10：请教下，11.3.0iServer突然间启动不了了，检查发现iObject Java的so都找不到了，但是iObjectsjava/bin目录下的so文件都还存在，如何解决？

11.3.0
【解决办法】检查组件bin目录下依赖是否缺少，如果缺失先补全依赖，然后再配置组件bin，并用source使其生效
export UGO_HOME= /iServer安装目录/support/objectsjava
export LD_LIBRARY_PATH =$UG{O}_{H}OME/Bin:$LD_LIBRARY_PATH

二、SuperMap iDesktopX

问题1：iDesktopX视频投放在地图上的大小由哪些参数决定，尺寸不对。

11.3.0

【问题原因】导入后视频没有进行配准，所以尺寸与实际不匹配
【解决办法】创建视频数据集时选择正确坐标系，然后使用视频配准功能，保存配准参数

问题2：iDesktopX桌面SQL查询中SUM函数如何使用？同语句在.NET版可用。

11.3.0

【解决办法】聚合函数作为输出结果时，需要设置在“高级->结果字段”中，默认表达式仅支持SQL过滤条件。

问题3：iDesktopX 12影像匀色总是失败，对影像数据有什么要求？

12.0.0

【解决办法】1、在使用影像匀色前需新建/打开遥感工作空间；
2、使用匀光匀色方法时要求影像模板范围完全包含输入影像范围，如果仅存在相交关系，建议使用自适应匀色或颜色映射匀色方法。

问题4：iDesktopX切矢量瓦片，style.json中的layers和地图layer数量对应不上。

11.3.0

【解决办法】iDesktopX 在生成矢量瓦片时将面数据拆分为填充面（Fill）和轮廓线（Outline），这是遵循 Mapbox 矢量瓦片（MVT）规范的典型行为。在 Mapbox 样式中，几何要素的填充和边框被视为独立的样式层，因此一个带边框的矢量面在生成瓦片时会自动分解为两个逻辑部分，所以会存在所谓的layers数量对不上的情况，这是正常的。

问题5：iDesktopX连接DMSpatial (DM8) 数据库失败，提示数据源创建失败。

11.3.0
【问题原因】连接时没有填写数据库
【解决办法】需要完整填写连接数据库的名称

问题6：使用mxd迁移后，转换后的工作空间有密码。

11.3.0

【问题原因】磁盘空间已满导致文件损坏。 【解决办法】清理磁盘空间后重新迁移，工作空间正常。

问题7：询问iDesktopX 11.3 ARM版本最新的双周包下载地址。

11.3.0
【解决办法】提供了百度网盘下载链接和提取码。
https://pan.baidu.com/s/1r4q55GpBItgLbP90LEg67g?pwd=6655

问题8：SKP三维数据无坐标系，指定坐标系后缩放数据消失，如何解决呢？

11.3.0
【解决办法】模型导入时未设置坐标系，导入后坐标系为平面无投影，需要先定义为投影坐标系再投影转换为地理坐标系

问题9：将OSGB格式的倾斜摄影数据入库生成S3MB并发布服务后，发现模型与底图的坐标偏移比原始数据更大，咨询此问题的解决方法。

11.3.0

【问题原因】数据需要在平面场景中加载，但是倾斜入库的时候勾选了坐标转换
【解决办法】倾斜入库时取消勾选坐标转换即可

三、SuperMap iDesktop

问题1：使用3ds Max插件转UDB，纹理丢失，Max中预览正常。

11.3.0

【问题原因】3dmax中使用了物理材质，max插件仅支持标准材质
【解决办法】将模型的物理材质替换为标准材质。注：若max 中找不到 标准材质，请参考下方链接
https://www.autodesk.com.cn/support/technical/article/caas/sfdcarticles/sfdcarticles/CHS/Standard-Legacy-Materials-don-t-appear-in-3ds-Max-2021.html

问题2：本地iDesktop连不上许可中心的许可，可用套数0。

11.3.0
【解决办法】重启Web许可中心后可以正常连接。

问题3：iDesktop模型打散算子的规则是什么？

11.3.0

【解决办法】功能将模型数据集打散，使每个数据变成一个对象，无特殊要求。

问题4：请求3ds Max插件的下载地址。

11.3.0
【解决办法】提供官网下载链接：https://support.supermap.com/DownloadCenter/ProductAuxiliary.aspx

问题5：iDesktop 11i本地瓦片转MongoDB瓦片，62.5GB数据导入失败。

11.1.0

【问题原因】mongodb开启了验证模式，无法导入数据进去
【解决办法】关闭验证模式

问题6：使用2024版Max插件导出模型，在3ds Max中显示正常，但在iDesktop中部分模型偏离原来位置，如何解决呢？

11.3.0
【解决办法】偏移模型的材质需要修改为可编辑多边形

问题7：在进行iDesktop Java桌面扩展开发时，尝试启动调试时程序报错。

11.3.0

【问题原因】
现存一个早期的iDesktopX二次开发工程，已无法查询出创建该工程时使用的iDesktopX版本。
将工程依赖指向iDesktopX11.3.0后，启动运行异常。 判断是项目中配置文件不兼容iDesktopX11.3.0。
【解决办法】
使用 iDesktopX11.3.0 新建一个iDesktopX工程（ “视图”->“新建二次开发工程”），将该项目中的代码迁移到新工程中，即可运行

问题8：通过TIN地形数据拉伸生成的闭合体模型，其侧面纹理是否支持修改以及如何修改。

11.3.0
【解决办法】不支持修改，根据原始需求推荐使用iClient3D for WebGL 在前端开挖地形：http://support.supermap.com.cn:8090/webgl/examples/webgl/editor.html#TerrainExcavation_Pull-out

问题9：使用iDesktop向金仓数据库上传自定义北京2000坐标系的图层，但在不同电脑上操作，系统为该坐标系分配的SRID不同，导致数据不一致。

11.3.0
【解决办法】使用最新的iDesktopX12.0.1已能工作正常，下载地址：https://pan.baidu.com/e/1wNzBeX8b3kXPVwkvNSq2ug

四、SuperMap iClient3D for WebGL

问题1：三维客户端缓存加密在哪里设置？

11.3.0

【解决办法】该功能已过时，推荐通过对缓存加密或者设置三维服务权限来保护数据安全。

问题2：官网示例中三维聚合背景有阴影，如何去掉？

11.3.0

【问题原因】背景透明图片受大气层影响。 【解决办法】1. 关闭大气：scene.skyAtmosphere.show = false; 2. 设置天空盒背景。

问题3：倾斜影像首次加载慢，飞行效果不好，页面模糊，如何优化？

11.3.0
【解决办法】1、数据层面优化参考官方博客：https://blog.csdn.net/supermapsupport/article/details/126308262；
2、前端层面优化参考S3MTilesLayer.LoadingPriority接口使用空间索引方式加载。

问题4：WebGL中s3mlayer通过removeAllObjsOffset移除偏移后，缩放地图偏移效果重新出现。

11.3.0
【解决办法】使用S3MTilesLayer.removeAllObjsTranslate方法即可正常去除模型偏移。

问题5：通过iServer的scene服务加载文字标注专题图时，图层第一次加载时标注文字显示不全，需要取消勾选再重新勾选图层才能正常显示。

11.3.0
【问题原因】生成标签三维瓦片的iDestkopX存在缺陷。
【解决办法】使用最新的iDesktopX12.0.1 重新生成标签三维瓦片，已能正常显示。
下载地址：https://pan.baidu.com/e/1wNzBeX8b3kXPVwkvNSq2ug

问题6：在前端界面上对图层进行加载后，再取消加载操作，程序会出现报错？

11.3.0

【问题原因】报错信息显示，在渲染过程中某个对象没有被正确初始化或已经被销毁，但代码里还尝试去访问它的 alpha 属性；
【解决办法】
打开浏览器调试工具，在“取消勾选”前后，用 console 或断点查看对应图层/数据对象是否存在、有没有被正确销毁，如果没有正确销毁，完善相关代码。

五、SuperMap iObjects Java

问题1：iObjects Java组件是否有接口在启动前判断传统许可是否正确？

11.3.0
【解决办法】只有云许可和Online许可才需要每次调用时连接，其他不必每次判断
“java.lang.IllegalStateException: connect types is: 30002 , …, 65400 , … , hasp_feature_not_found”这种报错就是没有许可，100xx就是10i，200xx就是11i，300xx就是12i

问题2：如何使用iObjects组件完成桌面端的TIF影像切图？

11.3.0

【解决办法】参考帮助文档中的ImageCacheBuilder类，具体参考https://support.supermap.com/DataWarehouse/WebDocHelp/iObjectsJava/index.html

问题3：空间分析SQL查询另存结果字段名被添加"_1"。

11.3.0

【解决办法】建议使用官网版本12.0.1 (12.0.1.0.125282) 保存查询结果，字段名不会改变。

问题4：iObjects开发中，参数化面几何对象和普通面对象求相交出错。

11.3.0

【解决办法】Geometrist.intersect方法仅支持特定几何类型。计算相交时，可以通过GeoCurvePolygon的convertToRegion()方法转换为GeoRegion再进行相交查询。

六、SuperMap iClient for JavaScript

问题1：iClient for Leaflet 用divicon实现的marker，添加标注,数据量大的时候会出现偏移现象

11.3.0
【解决办法】iconAnchor参数设置有误差，用户根据实际业务需求重新调整该参数后正常

问题2：Leaflet 地图裁剪 clipRegion设置范围后，仍然还是显示了部分裁剪区域外的地图

11.3.0

【问题原因】iServer 缓存导致
【解决办法】清空iServer 地图范围，或者是设置cacheEnabied=false，关闭使用缓存

问题3：OpenLayers调用iServer矢量瓦片REST服务，Vue3+Vite环境下无法使用ol-mapbox-style插件（因其为UMD全局注入，Vite强制ESM）。

11.3.0
【解决办法】注意一下几点：
1、index.html不要引入olms的js
2、vite.config.js里边要配置vite-plugin-commonjs为了处理非es模块的js
3、olms的js单独放在libs文件夹下，没有就新建，然后在vue文件用import引入

七、SuperMap Unreal Engine

问题1：UE 12.0.1.0开发环境示例关卡启动后按钮图标全白。

12.0.0
【问题原因】客户重新设置了计算机的编码规则，导致产品包中中文名称的uassat文件，计算机读取是乱码，工程中找不到文件路径出现显示异常；
【解决办法】客户自行更改计算机编码规则后重新下载产品包，目前暂时拷贝一份产品包到客户计算机上，可正常使用。

八、SuperMap iMobile Android

问题1：iMobile开发包缺少部分so文件（libarcore等），如何获取？

11.2.1

【解决办法】新版本不需要这些so文件，统一使用sceneform-sm-11.2.0.aar。

九、SuperMap iPortal

问题1：哪里可以下载湖北县级地形图的配图工作空间和数据？

11.3.0
【解决办法】通过SuperMap Online资源中心下载，位置在“数据”栏目中。链接：https://www.supermapol.com/resource-center/public/all

平台产品线高频问题集合汇总表

https://lexiangla.com/teams/k100048/docs/ad346a06e82511ee87832effa0562057