SuperMap GIS基础产品FAQ集锦(20251020)

一、SuperMap iServer

问题1：咨询iServer 11i版本重置管理员密码需要执行bin目录下的哪个脚本文件，并反馈重置失败。

11.3.0

【解决办法】

1. 先通过ps -ef|grep iserver命令检查并杀掉残留的iServer进程。
2. 重新执行重置密码脚本。用户反馈在重启服务后重置成功。

问题2：咨询iServer的叠加分析服务的输入参数是否可以传递多个面要素，并请求一个样例。

11.3.0
【解决办法】datasetOverlayResults的叠加分析中多面要素参考如下：
[{
“style”: null,
“parts”: [
4,
4
],
“points”: [

{ “y”: 2189722.842328047, “x”: 12097707.564501455 }
,

{ “y”: 2189716.1041539256, “x”: 12097717.93112904 }
,

{ “y”: 2189695.6714484845, “x”: 12097750.330666834 }
,

{ “y”: 2189722.842328047, “x”: 12097707.564501455 }
,

{ “y”: 2241163.789333026, “x”: 12287441.109074341 }
,

{ “y”: 2240094.9565072134, “x”: 12287515.141545096 }
,

{ “y”: 2239016.7129368973, “x”: 12287898.337741459 }
,

{ “y”: 2241163.789333026, “x”: 12287441.109074341 }
],
“type”: “REGION”
}]

问题3：iServer中选择发布数据集时，选定数据集并保存后，再次打开该界面找不到已选的数据集。

11.3.0
【问题原因】老版本缺陷，新版本已修复
【解决办法】下载最新包使用：https://pan.baidu.com/s/1xbv6s5vlbqw_uMg9J9hgJw?pwd=6655

问题4：在Linux环境下执行清除许可命令后，许可被成功清除，但并未在对应目录生成c2s文件。

11.3.0

【解决办法】将licx和id文件均放到/opt/SuperMap/License下面下面，再执行-licensetool.sh -clear后生成了c2s文件

问题5：咨询iServer是否支持多用户管理，希望新增一个用户来管理不同部门的数据。

11.3.0
【解决办法】支持。iServer提供多用户及权限管理功能，可以创建不同的用户和角色，并为它们分配不同的资源访问和管理权限。具体设置可参考官方帮助文档。

问题6：使用数据库型数据源制作的地图，在iDesktop中预览正常，发布为iServer服务后，服务缩略图也正常，但访问服务时只显示部分数据。

11.3.0
【问题原因】地图范围不正确，且修改范围后iServer侧存在缓存未更新。 【解决办法】在桌面软件中重新计算数据集范围并保存工作空间，然后在iServer服务管理页面清除服务缓存并重启服务。

问题7：咨询如何删除iServer服务管理界面上的版权信息。

11.3.0

【解决办法】可参考技术博客教程进行操作：https://blog.youkuaiyun.com/supermapsupport/article/details/144744640，其中1.4章节有详细说明。若管理界面的无法去除，可进一步沟通。

问题8：咨询iServer 11.3版本是否支持在银河麒麟操作系统上部署和运行。

11.3.0
【解决办法】支持。用户需根据银河麒麟系统的CPU架构（如ARM、x86等）下载对应Linux版本的iServer安装包。

问题9：咨询在麒麟V10操作系统上，能否从已安装的iServer 11.1版本升级到iServer 11.3版本。

11.3.0
【解决办法】1. 确认在GLIBC为2.28，GCC 为7.3.0版本的麒麟v10系统上，可以支持安装iServer 11.3.0。 2. 客户已安装iServer11.1 想升级到11.3.0版本，可采用SuperMap iServer 产品升级脚本文件 autoUpgrade.sh 文件( Linux 平台)，快速升级。

问题10：iServer启动时日志报“V5缓存配置文件不存在”，但服务能正常使用，咨询该报错原因。

11.3.0
【问题原因】之前发布的ugcv5服务数据丢失
【解决办法】找到有问题的数据并清理掉即可

问题11：iServer经过Nginx代理或配置HTTPS后，请求S3M瓦片时，若瓦片名称中含有“+”字符则请求失败，咨询原因。

11.3.0
【解决办法】特殊符号“+”未转义成功，需要在Nginx代理中手动处理一下编码的问题，可以参考:https://blog.youkuaiyun.com/LLittleF/article/details/93879077

问题12：iServer 11i基础版许可，在使用客户自行下载的安装包部署后，地图服务和数据服务模块显示不可用，咨询是否为安装包与许可不匹配导致。

11.3.0
【问题原因】iserver缓存问题，初次启动没有读取到许可
【解决办法】使用浏览器无痕模式，重启iserver后可以正常读取许可

问题13：咨询如何修改配置，以避免iServer服务从HTTP改为HTTPS后，页面样式丢失的问题。

11.3.0
【解决办法】该问题可参考技术博客文章进行解决：https://blog.youkuaiyun.com/supermapsupport/article/details/141896415

问题14：咨询iDesktop/iServer是否支持将包含WEB类型数据源的工作空间发布为地图服务。

11.3.0
【解决办法】不支持。包含Web类型数据源的工作空间不能直接发布为地图服务。
web数据源先移除，如果需要前端添加做为地图，直接前端代码添加，参考各产品示例。

问题15：iServer 10版本检测出漏洞CNVD-2025-14393，咨询最新双周包是否已修复，以及官网为何查询不到该漏洞信息。

11.3.0
【解决办法】补丁包已经处理了，下载官网补丁包替换即可

问题16：iServer配置代理之后，wmts服务能力文档里记录的href地址还是代理前的，该怎么解决？

11.3.0
【问题原因】代理配置错误
【解决办法】按照文档重新配置代理即可：https://help.supermap.com/iServer/zh/Subject_introduce/Security/systemSecurity/proxy/nginx.htm

问题17：使用新解压的iServer 11.3版本进行快速发布服务时出现报错。

11.3.0

【问题原因】浏览器缓存问题
【解决办法】清理浏览器缓存后，iServer使用正常

问题18：使用iServer 10.2.1的打印服务功能时，输出的地图和图例内容均为空白。

10.2.1
【问题原因】客户打印内容中的地图服务地址和图例地址存在乱码，导致iServer识别不到地址
【解决办法】修改为正确的地址即可

问题19：iServer导入正式Web许可时，提示“包含未识别的模块”。

11.3.0

【问题原因】10版本和11版本的许可不能出在一起
【解决办法】需要统一许可版本，统一使用为10版本或11版本

二、SuperMap iDesktopX

问题1：使用三维地理设计中参数化建模的线性拉伸工具生成的白膜数据，如何发布带有轮廓线的服务？

11.3.0
【解决办法】
1、右键模型数据集生成三维瓦片，参数面板勾选“带边框”；
2、将三维瓦片添加到场景中，在风格设置中设置填充模式为“填充与轮廓”，线风格可设置轮廓线颜色和线宽，保存场景后以工作空间形式发布三维服务。

问题2：咨询iDesktopX 12.0版本是否支持导入.lcc格式的模型数据。

12.0.0
【解决办法】当前版本不支持导入.lcc格式。三维模型方面，12.0版本新增了对高斯泼溅数据(*.ply)的支持。

问题3：咨询官网文档中对制作三维点符号的3ds文件有大小限制，FBX, DAE, OBJ等其他格式是否存在同样限制。

11.3.0

【解决办法】目前新版本所有格式未作强制限制，但不建议过大，会影响性能。

问题4：咨询iDesktop是否有工具能按照建筑高度，为城市建筑白模批量贴上不同的材质。

11.3.0
【解决办法】没有直接的工具。一种可行的思路是：在生成白模前，根据高度阈值对建筑矢量面进行处理，例如将一个建筑面复制成多个，分别赋予不同的底部高程和拉伸高度，生成多个堆叠的模型对象，然后为这些不同的对象赋予不同材质。

问题5：在学校机房为多台电脑安装iDesktopX 11.3官网版后，部分电脑出现所有地图中的文字（注记、标签等）均无法显示的问题。

11.3.0
【解决办法】建议从以下几方面排查：1. 检查字体库是否完整，或尝试重新安装字体（以管理员身份）。2. 检查地图图层的显示参数，如显示控制、过滤条件等。3. 尝试重新解压安装软件。

问题6：咨询在iDesktopX中，是否支持对单个图层根据属性字段中的比例尺信息，制作专题图实现在不同比例尺下的分级显示。

11.3.0

【解决办法】不支持直接根据字段值设置。如需实现分级显示，需要制作多个专题图或复制多个图层，为每个专题图（或图层）设置不同的可见比例尺范围，并将它们组织在图层组中进行控制。

问题7：shp数据属性表在ArcGIS中打开正常，但在iDesktopX中打开显示为乱码，咨询处理方法。

11.3.0

【解决办法】编码问题，改为UTF-8后显示正常

问题8：咨询海图产品SuperMap iMaritimeEditor与iDesktopX的关系，以及海图基础版和高级版分别对标iDesktopX的何种配置。

11.3.0
【解决办法】海图高级版功能可理解为包含了部分iDesktopX标准版功能模块、空间分析模块，以及海图数据编辑生产等专业功能模块。详细版本划分可参考产品文档。

问题9：咨询是否能将二维矢量面数据的属性信息，根据空间关系批量关联（挂接）到三维模型数据集上。

12.0.0
【解决办法】当前版本尚无直接支持面与模型进行属性关联的功能。12i版本新增了模型属性追加算子，支持点与模型的属性更新。可尝试将矢量面转为点，再使用新算子进行属性更新作为替代方案。

问题10：咨询iDesktopX的数据迁移功能在迁移ArcGIS数据时，是否可以在不安装ArcMap桌面软件，仅有ArcGIS模块授权的情况下正常使用。

11.3.0
【解决办法】不可以，必须安装ArcMap。因为数据迁移功能会调用ArcMap安装包中的相关库文件来完成操作。

问题11：iDesktopX 12.0.0在麒麟V10系统上解压后启动时报错。

12.0.0

【解决办法】，12i 组件底层升级到 GLIBC 2.28 和 GCC 8.3 版本。麒麟v10系统自带的gcc和glibc版本低导致的，升级版本即可

问题12：设置统计图标记显示柱状对应的数量不生效？

11.3.0
【解决办法】客户打开多个iDesktopX，并且打开了同一份工作空间导致设置不生效，留下一个 iDesktopX 软件运行并设置统计图西标记显示柱状对应数量生效。

问题13：咨询iDesktopX软件启动时，是否可以设置默认不打开起始页。

11.3.0
【解决办法】在起始页或相关设置中可以勾选关闭。用户反馈勾选后需要先手动关闭一次起始页，该设置才会生效，否则下次启动仍会显示。

问题14：在生成三维缓存时，将对象ID字段设置为指定的业务字段后，如何验证该设置是否已生效。

11.3.0

【解决办法】生成缓存后，在桌面软件中加载该缓存数据，通过查询对比数据属性中的SMID字段值是否已更新为所选字段的值。注意，所选的对象ID字段必须为32位整型。

问题15：咨询在iDesktopX中，如何搭建GP模型以实现批量迭代本地影像数据，并对每幅影像执行栅格转矢量操作，最终输出与影像同名的多个矢量数据集。

11.3.0
【问题原因】GP模型直接以影像文件名作为输出数据集名称，但原始影像文件名不符合数据集命名规则。
【解决办法】将影像文件重命名，使其符合数据集命名规范后，搭建的GP模型即可正常运行。

问题16：在使用PostgreSQL数据库时，是否可以通过iDesktopX 在非public的schema（模式）下创建数据库型数据源?

11.3.0
【解决办法】在数据库中指定模式下创建 postgis 扩展后在 iDesktopX 新建数据库型数据源并打开，即可在非 public 模式下创建数据型数据源。

问题17：同样一个fbx模型文件用.net版本导入坐标是正值，用11.3 x桌面导入是负值，能帮忙看下吗？

11.3.0
【解决办法】在3DMax查看模型本身就在海里的，在x桌面中计算了下模型中心的位置，与3DMax中一致。如果需要不在海里，通过处理原始模型解决。

三、SuperMap iManager

问题1：硬件网络锁插入用户专网服务器后，在专网内的电脑上无法访问1947端口，许可工具也无法读取到锁信息，咨询原因。

11.3.0
【解决办法】首先检查服务器防火墙是否关闭，或是否已开放1947端口。若设置后仍无法访问，可参考技术博客：https://blog.youkuaiyun.com/supermapsupport/article/details/88966868中第四部分1、2节进行处理。

问题2：部署了iServer和AgentX的服务器存储空间不足，怀疑是机器学习操作产生大量临时文件，咨询是否可以清理。

11.3.0

【解决办法】并非SuperMap系列产品产生临时文件导致，是iServer和AgetnX部署的目录本身剩余空间有限，建议更改合适的目录重新部署。

问题3：iManager出现异常卡顿，各项服务时常无法加载出来，请求解决方案。

11.3.0
【问题原因】云套件网关服务规格过低（2c4g），在较大访问量下存在性能瓶颈。 【解决办法】将云套件网关服务的规格调整为8c16g，以满足访问需求。

问题4：反馈经典版iManager存在安全问题，在未登录的情况下，用户可以直接下载pem证书文件。

11.3.0

【解决办法】进入imanager-ui容器后，将private.pem文件移动到certs目录即可规避漏洞。

问题5：在iManager for k8s环境中导入试用许可文件时，系统提示“文件格式错误”，咨询原因。

11.3.0
【解决办法】12版本的前期许可中心不支持iportal基础版，需要更新为较新版本（202508以后）的许可中心

问题6：咨询硬件网络锁在Linux环境下的激活和配置使用方法，以及如何将其许可分配给同网段的iManager服务使用。

11.3.0
【解决办法】1. Linux下单机锁或网络锁的驱动安装和配置，可参考技术博客：https://blog.youkuaiyun.com/supermapsupport/article/details/71194464 和 https://blog.youkuaiyun.com/supermapsupport/article/details/88966868。 2. iManager配置使用硬件网络锁，可参考官方帮助文档中关于硬件许可的部分。

问题7：云套件（iManager）更新Web许可后，接口调用报错，返回错误码707。

11.2.1

【问题原因】许可文件中含有无法识别的模块（iPortal基础版许可）。
【解决办法】升级云套件中bslicense-server至11.2.0+版本tag镜像或者升级web许可中心至3.0.37+版本即可支持。

问题8：咨询部署AgentX时，是否必须同时部署iServer和iPortal，以及对iServer和iPortal的版本要求，11.3.0版本在CentOS 7系统上是否可行。

11.3.0
【解决办法】1、AgentX的核心能力依赖于iServer和iPortal实现，建议部署AgentX的同时也部署iServer和iPortal；
2、AgentX必须搭配12.0.0的iServer和iPortal使用，不支持11.3.0。

问题9：安装iManager的服务器监控插件时，安装程序报错提示“iServer组件错误”，无法正常安装。

11.3.0

【问题原因】该iServer是war的方式部署的，故会在系统环境变量中添加iServer的组件目录
【解决办法】先将iServer的组件在系统环境变量中给取消掉，待安装完成监控后再修改回去

四、SuperMap iDesktop

问题1：用户反映使用iDesktop将布局导出为图片时，感觉图片精细度较低，咨询如何调整。

11.3.0
【解决办法】在导出图片时，可以尝试调大分辨率（DPI）参数，并选择无损压缩的图片格式（如PNG）或设置为不压缩，以提高输出图片的清晰度。

问题2：管线数据创建三维管网、添加到球面场景并设置管点符号后，部分自适应管点符号显示异常，如何解决呢？

11.3.0

【解决办法】重新生成三维网络数据集后正常

问题3：基于iDesktop 11.2版本导入mdb数据时报错转换失败。

11.2.1

【问题原因】导入mdb需要使用Microsoft Access数据文件结构，系统中可能未安装AccessDatabaseEngine.exe驱动。
【解决办法】前往微软官网下载并安装AccessDatabaseEngine.exe驱动程序。

问题4：在iDesktop的地图选项中将DPI设置为非96的值后，重启iDesktop会被重置回96，咨询如何持久化设置。

11.3.0

【问题原因】该DPI设置项不会被保存，每次重启会重置。
【解决办法】若为加载WMTS服务，可在添加服务时，于URL末尾增加DPI参数，例如 …/wmts?DPI=90.17。

问题5：.dxf格式数据导入iDesktop后，在地图中打开为空白，转换为简单数据集后属性数据显示不出来。

11.3.0

【问题原因】CAD中通常为黑底白线，导入iDesktop后，由于iDesktop默认为白底，白色的线和文字因此不可见。 【解决办法】修改iDesktop地图的背景色为深色即可正常显示。

问题6：使用iDesktop 11i版本对约100G的地图数据进行多任务切图时，处理效率低下，咨询相关的性能优化手段。

11.3.0
【解决办法】(1)、对大数据量的数据，创建空间索引。
(2)、提前对地图进行地图优化，提高地图的显示性能——此步骤可通过【性能诊断】来判断地图优化是否达到了标准，一般情况下地图刷新在1秒内（更高要求可参考300毫秒），可认为达到标准。
(3)、提高硬件性能（硬盘读写、cpu等）。
(4)、考虑使用单机多任务切图甚至多机多任务切图功能分布式切图。

问题7：使用iDesktop地图匹配工具时报错，提示时间字段格式不符合预期，但检查后发现是yyyy-MM-dd HH:mm:ss格式。

11.3.0

【解决办法】用于分析数据的time字段不是日期型的，是文本型。去新建一个日期型字段，将字段值统一更新过去，用新字段进行分析。

问题8：使用iDesktop 11.2、11.3及12.0版本对某影像数据进行地图裁剪时，总是出现裁剪不完整的情况，只有RGB三个波段中的第一个波段能被完整裁出。

12.0.0
【问题原因】想要实现的效果就是将背景去掉，但是由于影像数据质量不高，如果使用图层属性中的背景透明或者是无值透明，会将影像数据中某些像元一起透明掉
【解决办法】使用影像数据的掩膜功能，在数据集属性中设置显示范围为对应的边界矢量面，然后进行影像切图解决。

五、SuperMap iPortal

问题1：iPortal 10.2.1版本的admin管理员账号被锁定，咨询如何解禁。

10.2.1
【问题原因】因密码输入错误次数过多（如被暴力破解攻击）导致账号被安全策略锁定。
【解决办法】连接iPortal后端PostgreSQL数据库，找到security库中的users用户表，将admin用户对应的lockedtimestamp字段值设置为空即可解锁。

问题2：iPortal 2025版本在服务管理中发布服务后，首页的热门资源可以看到该服务，但在资源中心的服务列表中找不到。

12.0.0
【解决办法】iPortal安装在C盘，C盘空间不足，将iPortal包移动到其他空间足够的磁盘，再启动iPortal即可

问题3：iPortal的三维地球WebApp中配置好的场景（如视角、光照、特效等），存储在哪个文件中，以及是否可以下载共享。

11.3.0
【解决办法】对scene 资源发送get请求。如：http://localhost:8190/iportal/web/scenes/274887398.json，其中数字是场景的ID号，该请求返回结果中content包含了具体内容

问题4：iPortal启动时日志显示ES（Elasticsearch）无可用节点，导致iPortal无法启动，咨询解决方案。

11.3.0
【解决办法】用户做了特殊设置，需以非root用户启动ES，以root用户启动iPortal才能正常启动

问题5：反馈iPortal存在安全漏洞，在未登录状态下，通过构造特定URL（如：ip:8190/iportal/web/users/registered.json?username=test 的方式）可以枚举出系统中已存在的用户名。

11.3.0

【问题原因】开启注册账户功能后，匿名用户在注册账户的时候就会调用该接口遍历确保不会出现同名用户
【解决办法】iportal.xml中找到< registersetting>< allowRegister>true< /allowRegister>< registersetting>配置，将 true改成false即可

六、SuperMap iObjects Java

问题1：咨询如何使用iObjects组件代码实现“打开shp数据，并将其保存成地图”这一桌面端操作。

11.3.0
【解决办法】建议参考以下流程实现：
1、创建工作空间 new Workspace；
2、打开数据源 Datasource；
3、创建地图 new Map；
4、把数据源中的数据集添加到地图 map.getLayers().add；
5、保存地图 workspace.getMaps().add；
6、保存工作空间 workspace.save。

问题2：使用iObjects Java组件在无界面的服务端，对smwu工作空间中的场景进行增加或删除图层的操作。

11.3.0
【解决办法】
Scene scene = new Scene(workspace);
scene.open(workspace.getScenes().get(0));
//添加图层
scene.getLayers().add(layer);
//删除图层
scene.getLayers().remove(layer);
//保存场景
workspace.getScenes().add(“newScene”,scene.toXML());

问题3：咨询是否支持将数据存储在OceanBase数据库中。

11.3.0
【解决办法】OceanBase数据库兼容MySQL，数据库使用MySQL模式，桌面中可以尝试使用连接MySQL的方式进行连接测试。

问题4：使用iObjects Java 11.3，通过ImageCacheBuilder设置起始层级为9-17，但生成的栅格数据集影像缓存仍然是9-13层。

11.3.0
【问题原因】数据分辨率太低，底层根据数据分辨率会计算出一个默认的最大层级
【解决办法】如需生成层级更高的瓦片，需要提供分辨率更高的数据

问题5：使用iObjects Java 11i的ImportSettingDWG方法导入DWG文件时，特定DWG文件导入失败，而自行创建的DWG文件可以成功导入。

11.3.0
【解决办法】客户的DWG文件导出时出现乱码，再用iObjectsjava导入失败

七、SuperMap iClient3D for WebGL

问题1：如何在三维场景中实现最佳路径规划?

11.3.0
【解决办法】参考官方博客：https://blog.youkuaiyun.com/supermapsupport/article/details/131681536 或者使用 ajax 构造iserver的网络分析的最佳路径分析请求，使用返回的点数据创建一个线实体。

问题2：iClient for WebGL加载多个REST地图服务时，是否可以跨服务调整子图层的叠加顺序呢？

11.3.0
【解决办法】WebGL中获取不到地图服务的子图层，不支持调整子图层顺序

问题3：咨询在WebGL中对已加载的地图服务进行图形编辑（如线修面、编辑节点）的实现方法。

11.3.0

【解决办法】发布数据服务，将节点传到entity中去绘制出实体，再对实体做编辑，可以参考：https://www.supermapol.com/webgl/examples/webgl/editor.html#DrawAndEdit

问题4：咨询在纯国产化环境中，渲染百万级别BIM及全省DEM等大规模三维数据时的硬件配置推荐。

12.0.0
【解决办法】推荐使用12i版本产品，其对国产环境有优化。可参考测试硬件配置：CPU（飞腾D2000/FT2000或龙芯3A5000）、内存8G、显卡（摩尔s30）。同时在前端代码中设置性能优先模式：new Viewer(‘container’, { performancePreferenceMode : PerformancePreferenceMode.Performance })。

八、SuperMap 其他

问题1：申请服务器许可时，若服务器有两个网卡，应该使用哪个网卡的MAC地址进行申请。

11.3.0
【解决办法】建议使用物理网卡的MAC地址。可以通过运行许可命令获取信息，输出的MAC地址即为需要用于申请许可的地址。详情可参考博客：https://blog.youkuaiyun.com/supermapsupport/article/details/88966868 第7.2章节。

问题2：咨询计算机名（主机名）为中文是否会影响超图软件试用许可的申请和使用。

11.3.0
【解决办法】不影响，超图许可支持中文计算机名。

问题3：临时许可申请流程（OA：CT-SYXK-2025-022923）已审批通过，但未收到包含许可文件的邮件。

11.3.0
【解决办法】此类IT流程问题，建议通过公司内部渠道（企微-通讯录-员工服务-IT系统支持）进行反馈，由IT部门处理。

九、SuperMap iClient for JavaScript

问题1：在OpenLayers中，使用turf对地图点击点做缓冲区并进行空间查询，4326坐标系下正常，但3857坐标系下查询结果为空，咨询原因。

11.3.0
【问题原因】输出空间查询的Geometry，坐标值是4326
【解决办法】获取点击的坐标，生成Point点，再用Point点做缓冲区查询即可

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

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