一、SuperMap iServer

问题1：iServer发布REST地图服务后，在服务目录中使用queryResults功能创建查询结果时，提示“目标图层不存在”，但该图层在桌面端工作空间中是存在的。

11.3.0

【问题原因】图层命名包含特殊字符. 【解决办法】更改图层名称后解决

问题2：Windows环境下，将正式许可文件放到默认目录下激活，许可中心能看到模块，但iServer 11.3.0启动后无法读取到该许可。

11.3.0

【问题原因】C:\Program Files\Common Files\SuperMap\License目录下的许可id文件被误删。 【解决办法】在该目录下，手动新建一个以许可文件中<signature>标签内的id为名的.id空文件即可解决。

问题3：iServer 12i发布的动态地图服务，在地图缩放到一定级别后，会出现白色背景，数据不再显示。

12.0.0 【解决办法】清理cache目录下的缓存后，重新预览正常

问题4：存储在达梦数据库中的工作空间，在iServer 12i中发布服务时，打开工作空间失败。

12.0.0 【问题原因】客户那边是文件型工作空间和数据库型数据源，但是发布服务那里选择的数据库型工作空间 【解决办法】重新以文件型工作空间的形式发布服务即可

问题5：更新iServer正式许可后重启，日志显示许可检查结果为false，已按机器人提示排查但无效。

11.3.0 【解决办法】将许可放到opt/SuperMap/License目录下可正常读取

问题6：切好的地图瓦片本身没有白色边框，但通过iServer发布服务后，在前端浏览时瓦片间出现了白色缝隙。

11.3.0 【解决办法】更新到最新的11.3.0双周包后预览正常：双周包下载地址：https://pan.baidu.com/s/1xbv6s5vlbqw_uMg9J9hgJw?pwd=6655#list/path=%2F

问题7：由于漏洞扫描要求，需要将产品内置的Tomcat升级到8.5.100版本，咨询如何获取补丁包及具体升级操作步骤。

11.3.0 【解决办法】可以参考此博客文章中的步骤进行Tomcat的手动升级和替换：https://blog.csdn.net/qq_41134073/article/details/128647400

问题8：寻求适用于日常GIS系统使用（主要是iServer三维服务浏览）的国产电脑配置推荐。

11.3.0 【解决办法】可以参考官方iClient3D for WebGL产品介绍中的运行环境要求文档，其中列出了推荐的浏览器、操作系统和显卡配置。链接：https://www.supermapol.com/webgl/web/introduction/intro_3DWebgl.html#environment

问题9：使用iDesktop 10i为三维模型设置了透明度并生成三维缓存，但使用iServer 10i发布该缓存后，在服务中模型的透明效果丢失。

11.3.0 【解决办法】目前10i产品现在已过生命周期，测试12i产品正常，建议更新产品版本； 若无法更新，可在WebGL里面加载看下效果，做下处理： 1.如果WebGL有效，可以替换下iServer的内置包； 2.如果WebGL无效，可以在前端代码层面做下透明度设置：S3MTilesLayer.style3D.fillForeColor = new SuperMap3D.Color(1.0, 1.0, 1.0, 0.5);// 0.5为透明50%。

问题10：咨询iServer发布的服务是否有类似ArcGIS Server服务目录中提供的Query界面，用于交互式查询。

11.3.0 【解决办法】接口可以参考这个文档：https://help.supermap.com/iServer/zh/mergedProjects/SuperMapiServerRESTAPI/root/arcgisrest/featureService/query(Feature_Service).htm

问题11：咨询iServer的操作日志接口logsOperation.rjson是否支持按时间范围进行查询。

11.3.0 【解决办法】接口暂时没有，但是可以在前端对查询结果进行过滤

问题12：咨询iServer 10i版本是否支持在Windows Server 2019操作系统上运行，因帮助手册中最高只写到2016。

11.3.0 【解决办法】按照适配情况说明书，建议windows server 2019 部署12i(2025）及以上版本

问题13：iServer启动后找不到许可，但在许可中心的网页上能看到许可信息是正常的。

11.3.0

【解决办法】可以插锁机器执行以下命令重启许可服务即可 【systemctl stop hasplmd】 【systemctl start hasplmd】

问题14：iServer 11.3访问华为GaussDB V2.0数据库时连接失败，报错“Invalid or unsupported by client SCRAM mechanisms”，咨询应使用何种驱动。

11.3.0 【问题原因】GaussDB 默认用户认证算法是自定义的 sha256，产品无法默认支持。 【解决办法】以下2种方案均可解决，建议根据项目实际情况选择： 1、修改GaussDB的用户认证较验算法为md5； 2、参考GaussDB启用sha256加密验证Yukon数据源及服务访问验证方案使用GaussDB中的libpq依赖库替换 iDesktopX 中的，使其支持 GaussDB 的自定义 sha256 算法。

问题15：咨询第三方平台如何对接iServer的操作日志接口。在未登录状态下直接访问日志接口，会返回无权限错误。

11.3.0 【解决办法】使用管理员账户登录iServer生成一个有效的token，在请求日志接口时，将此token作为参数附加在URL中进行访问。

问题16：单机版iServer服务器被安全扫描工具检测出安全漏洞，咨询如何处理和修复。

11.3.0

【解决办法】iServer支持使用普通用户启动，只需要普通用户能读写iServer整个文件夹就可以

问题17：iServer 10.2.1版本中找不到用于配置账户密码合规性校验规则的 "accountInfoComplianceRules.xml" 文件，无法满足项目对密码复杂度的要求。

10.2.1 【问题原因】账户信息合规度校验功能是在iServer 11.1.0版本中新增的，10.2.1版本不具备此功能。 【解决办法】建议升级iServer到11.1.0或更高版本以使用该功能。

问题18：通过iServer数据服务接口查询数据时，返回的要素数量缺失，未达到数据总量，咨询是否是接口参数设置问题。

11.3.0 【问题原因】iServer数据服务查询接口默认返回的记录数为20条。 【解决办法】根据API文档，在请求时传递count参数来指定需要返回的要素数量。文档链接：https://help.supermap.com/iServer/mergedProjects/SuperMapiServerRESTAPI/root/data/datasources/datasource/datasets/dataset/features/features.htm

问题19：咨询iServer的空间统计分析功能是否必须依赖分布式分析模块的许可。

11.3.0 【解决办法】是的，根据官方产品介绍文档中的许可模块划分，iServer的空间统计分析功能需要分布式分析扩展模块的许可支持。文档链接：https://help.supermap.com/iServer/zh/Product_introduce/iServer_Introduce.htm

问题20：在Linux环境下，iServer 11.3.0版本可以正常识别试用许可，但在配置正式许可后，iServer无法读取到正式许可。

11.3.0 【问题原因】可能存在多许可文件冲突、配置缓存、权限不足或许可与环境不匹配等问题。 【解决办法】按照以下步骤排查：1. 确保许可目录下仅有唯一一个正式许可文件，并检查文件权限。2. 清除iServer配置文件（iserver-system.xml）中的许可缓存节点。3. 验证许可版本、机器信息与当前环境是否匹配。4. 使用licensetool.sh工具进行状态检查和调试。

问题21：iServer发布的TMS REST服务，在浏览器中点击服务地址打开后，页面显示为空白，无法正常预览服务内容。

11.3.0

【解决办法】坐标系问题，客户数据是EPSG：4490，换成4326和3857即可

问题22：在ARM架构环境下，iDesktopX 12i可以正常创建、打开并保存达梦（Dameng）数据库型工作空间，但使用同一台机器上的iServer 12i发布该工作空间时报错。

12.0.0 【解决办法】使用最新的iDesktopX和iServer双周包可正常发布DM工作空间。

问题23：咨询SuperMap iServer 10i版本具体支持哪些版本的Microsoft SQL Server数据库。

11.3.0 【解决办法】SuperMap iServer 10i 版本在Windows平台上明确支持Microsoft SQL Server 2008、2012和2016版本。对于更高版本，理论上可能兼容，但没有经过官方适配测试。

问题24：iServer发布PostGIS中由第三方GIS软件创建的数据集，无法进行预览（按钮灰色），咨询是否必须用iDesktop创建。

11.3.0

【解决办法】客户使用的是11.1.1，经测试11.3.0没有问题，协助客户升级iServer版本

问题25：iServer的geometry服务测距接口，当传入的点坐标数组参数过长时，GET请求会返回400错误，且该接口不支持POST，询问是否有解决办法。

11.3.0 【问题原因】 接口：geometry服务距离量算/iserver/services/geometry/restjsr/v1/geometry/distance 点串输入点过多GET请求无法处理 【解决办法】用post模拟get请求，参见帮助文档：https://help.supermap.com/iServer/mergedProjects/SuperMapiServerRESTAPI/clientBuildREST/POST_GET.htm

问题26：对省级范围（约1100万条记录）进行分布式叠加分析（裁剪），结果的图斑数量（800万条）比原始数据少了约300万条，差异巨大。虽然总面积变化不大，但记录数的大量减少不符合预期。

11.3.0 【解决办法】1、Spark参数填写错误，导致分区失效。分区参数为spark.bdt.1st.index 2、数据的分区字段OBJECTID存在多个重复值，需切换新的分区字段，该字段要求值唯一，不重复。

问题27：咨询SuperMap iServer产品是否提供REST API接口，用于计算一个点对象到线要素最近的垂直距离。

11.3.0 【问题原因】SuperMap iServer产品当前版本未提供直接计算点到线要素最近垂直距离的接口。 【解决办法】可以参考或使用第三方开源的Cesium计算方法作为替代方案实现该功能，参考链接：https://blog.csdn.net/ztnhnr/article/details/107837396

问题28：iServer发布的动态地图服务，在前端请求PNG格式的瓦片时，服务返回的瓦片图片内容为空（文件大小为0KB），导致地图显示异常。而请求JPG格式的瓦片则正常。

11.3.0 【问题原因】由于iServer缓存导致 【解决办法】删除对应缓存即可。缓存目录：\webapps\iserver\output\cache

问题29：iServer服务运行正常，但地图出图缓慢，浏览器中部分瓦片加载卡住。排查发现，工作空间中的数据源因防火墙导致连接异常，调整后问题依旧。需要进一步定位出图卡顿的根本原因。

11.3.0 【问题原因】客户的缓存配置不知道被谁关掉了,导致服务都是动态出图,没有试用缓存配置,所以较之前很慢 【解决办法】开启各个服务的缓存,开启后验证项目服务出图速度正常

问题30：用户在使用GIS平台产品连接数据库时遇到问题，初步排查怀疑是数据库用户权限不足所致，但缺乏具体错误信息和场景描述。

11.3.0 【问题原因】客户使用的用户权限不足。 【解决办法】使用超级管理员账户新建数据源，然后给指定用户赋需要的权限。

问题31：咨询如何正确配置以修复iServer的WebPrinting服务存在的SSRF（服务器端请求伪造）漏洞，并提供了当前的配置截图进行确认。

11.3.0 【解决办法】针对WebPrinting服务的SSRF漏洞，需要在iServer的配置文件中设置白名单（whitelist），只允许访问白名单内的地址。具体配置方法参考官方帮助文档：https://help.supermap.com/iServer/iS/use_iserver/usewebprinting/create_printingjob.htm#whitelist

问题32：咨询如何修改iServer的安全配置文件shiroUrls.ini，实现仅允许PUBLISHER角色的用户通过/services/security/tokens接口请求token，禁止ADMIN角色访问该接口。

11.3.0 【解决办法】在shiroUrls.ini配置文件中，将/services/security/tokens* = 路径的访问权限设置为 roleFilter[PUBLISHER]，即可实现指定角色访问控制。

问题33：咨询iServer 11.3.0的任意文件上传漏洞相关问题，包括双周版本是否已修复、是否仍需手动配置，以及如何彻底阻断文件上传功能。

11.3.0 【解决办法】1. 11.3.0官方双周版本未修复此漏洞，需使用另外提供的紧急临时包。 2. /iserver/manager/filemanager/uploadtask接口无需手动配置，开启密码防暴力破解即可。 3. 无法完全阻断文件上传，但可通过修改iserver-system.xml配置文件中的<deniedFiles>配置项来限制上传文件的格式。

问题34：访问iServer服务时，页面报错“Internal Server Error”，具体错误信息为“java.lang.IllegalArgumentException: fromIndex(0) > toIndex(-1)”。

11.3.0 【问题原因】日志分析显示，错误是由于执行统计的SQL语句有问题。此问题与之前为防止SQL注入所做的配置有关，导致某些服务请求参数不符合新的安全规则。 【解决办法】修改服务的请求参数，使其符合防SQL注入配置的规则。修改后服务访问恢复正常。

问题35：客户对数据库进行restore恢复操作后，iServer中原先正常发布的工作空间服务出现问题：在iDesktopX中地图可正常显示，但在浏览器中预览地图服务时，只显示一个对象。

11.3.0 【问题原因】日志显示iServer的sqlite数据库文件（accessrecords.db）被锁定，可能是由于上次关闭iServer时进程未完全终止。 【解决办法】彻底关闭所有iServer相关进程（可使用ps -ef | grep iserver命令检查），然后重启iServer服务即可恢复正常。

问题36：用户需要在信创环境中（鲲鹏CPU、麒麟系统）部署iServer，咨询官网是否有对应的ARM架构安装包。

11.3.0 【解决办法】针对鲲鹏CPU和麒麟系统的信创环境，应在超图官网下载中心选择Linux平台的arm64版本的iServer产品安装包。

问题37：在iServer集群环境下，Web打印出图功能报错，提示找不到对应的打印任务ID。

11.3.0 【问题原因】Web打印是异步任务，包含“创建任务”和“执行任务”两次请求。在集群环境中，若两次请求被Nginx转发到不同节点，会导致第二个节点找不到由第一个节点创建的任务ID。 【解决办法】修改Nginx配置文件，为Web打印服务的URL路径（/iserver/services/.*/rest/webprinting/）添加基于ip_hash的转发策略，确保来自同一客户端的连续请求被固定转发到同一个iServer节点。

问题38：在iServer中使用GPA模型读取瀚高安全版数据库中的数据集时报错，错误信息指向JDBC连接或认证问题。该模型在桌面端可以运行，但在保存结果时也报错。

12.0.0 【问题原因】iServer及内置的Spark环境未使用支持瀚高安全版数据库（SM3认证）的特定JDBC驱动，导致连接失败。 【解决办法】按照指导，将支持SM3认证的postgresql驱动jar包，替换到iServer安装目录下的4个指定位置（webapps/iserver/WEB-INF/lib、geoprocessing-server.iar、以及两个bdt-all-runtime.jar包内），替换后问题解决。

问题39：咨询在iServer服务管理页面中，如何查看数据集中所有要素的属性，或通过属性字段条件进行查询，而不仅仅是通过SmID查询单条记录。

12.0.0 【解决办法】在iServer服务列表页面，可通过以下方式查询要素属性：1. 点击地图服务，进入数据服务列表。2. 点击具体的数据集服务链接，进入服务详情页面。3. 页面下方提供了多种查询接口，如“ID查询”可通过SmID查询，“SQL查询”则支持使用SQL条件表达式（如 NAME='xxx'）对指定字段进行查询，从而获取满足条件的要素属性。

问题40：在iServer中发布UGCV5瓦片服务后，点击预览时返回500错误，报错信息为Cannot invoke "org.restlet.data.Reference.toString()" because the return value of "org.restlet.data.Reference.getBaseRef()" is null。

11.3.0 【问题原因】在iServer中对应的服务配置文件可能已损坏或状态异常，导致服务无法被正确调用。 【解决办法】在iServer服务管理器中，将该异常的瓦片服务删除，然后重新进行发布操作。

问题41：通过iClient前端访问经过代理发布的iServer WMTS服务时，服务返回的Capabilities元数据XML文件中的ResourceURL地址为iServer服务器的内网地址，导致外网客户端无法访问。

11.3.0 【解决办法】在代理服务器（如Nginx）上配置内容过滤和重写规则。使用sub_filter等模块，在响应体中将内网地址动态替换为代理服务器的外网地址，从而确保客户端能够获取到正确的服务地址。参考链接：https://blog.csdn.net/supermapsupport/article/details/127074609

问题42：使用iServer发布单个PostGIS数据源的数据服务时报错，但该工作空间发布的地图服务正常，且本地桌面端显示也正常，导致数据服务无法使用。

11.3.0 【问题原因】数据库型数据源未设置坐标系 【解决办法】对数据源设置任一坐标系即可

问题43：将多个SCI缓存文件在iDesktop的地图中叠加显示正常，但通过文件型工作空间发布到iServer后，部分SCI瓦片图层无法显示。

11.3.0 【问题原因】多个SCI格式的缓存瓦片文件的坐标系不一致。在iServer中通过工作空间发布或创建复合瓦片服务时，要求所有瓦片图层的坐标系必须保持一致，iServer不会对已生成的瓦片进行动态投影转换。 【解决办法】在iDesktop中，重新组织切图前的源地图，确保地图本身的目标坐标系统一为4326。然后，对坐标系不一致的数据重新生成瓦片，保证所有待发布的SCI瓦片坐标系一致，再发布到iServer中。

问题44：咨询是否有默认开启HTTPS功能的iServer 12镜像包，希望能将Nginx反向代理的HTTPS配置直接集成在镜像内，从而免去用户手动配置的步骤。

12.0.0 【问题原因】由于HTTPS配置（如证书、域名等）与用户的实际部署环境强相关，无法在官方镜像包中进行通用化的预置。 【解决办法】用户需根据项目实际环境，参考官方文档自行配置Nginx并开启HTTPS。参考链接：https://blog.csdn.net/zi_chengbo/article/details/123735539

问题45：在iServer 12版本中发布三维场景工作空间（sxwu/smwu）时，系统提示错误“工作空间中场景的数目为0”，导致发布失败。而发布普通二维工作空间是正常的。

12.0.0 【问题原因】服务器上的数据存储路径中存在两级同名目录（例如 /path/data/data），导致iServer在解析工作空间路径时出错，误判工作空间内不含任何场景。 【解决办法】在iServer发布服务时，不要通过文件浏览器选择工作空间，而是将工作空间的真实物理路径（避免同名目录结构）手动复制并粘贴到“工作空间路径”输入框中，然后进行发布。

问题46：iServer地理处理建模（GPA）中，一个用于叠加分析的简单模型在运行时报错“图形不正确”。尽管输入的两个数据集（地类图斑、永久基本农田）在iDesktop中均可正常浏览。

11.3.0 【解决办法】升级到12.1.0beta版本后客户验证正常https://support.supermap.com/product/iServer.aspx

问题47：iServer实例上的所有服务突然无法访问，统一提示“资源不存在”，重启iServer服务后恢复正常。同时，另一个iServer实例也出现宕机，需要排查原因。

12.0.0 【问题原因】存在两个问题：1. 一台iServer 12i (2025u1) 实例的许可配置错误，在系统配置文件中关联了旧版本的Web许可，导致许可校验失败，服务实例被销毁。2. 另一台iServer实例发生宕机，但其日志文件（catalina.out）过大（91GB），无法直接查看和分析宕机时刻的具体原因。 【解决办法】1. 针对许可配置错误的iServer，编辑其webapps/iserver/WEB-INF/iserver-system.xml配置文件，删除错误的Web许可配置节点，重启服务使其正确加载文件许可。2. 针对日志文件过大的问题，建议停止iServer服务，备份并清理当前的logs/catalina.out日志文件，以便在问题复现时能够快速定位。

问题48：iServer 10i版本后台日志出现“出图失败”错误，导致WMS服务间歇性不可用，怀疑是并发限制，但找不到配置项。

10.2.1 【问题原因】客户机器磁盘满了，无可用空间。 【解决办法】清理磁盘，预留更多的可用空间，重启iServer，WMS服务恢复正常。

问题49：咨询iServer 12.0.1版本中，服务管理页面是否已将所有功能都迁移到新版UI，是否存在“搬迁至旧版UI”的入口。

12.0.0 【解决办法】iServer 12.0.1版本中，部分功能（尤其是非常用功能）尚未完全从旧版UI迁移至新版UI。在iServer服务管理页面的左下角，仍然保留有“返回经典版”的入口，可以切换回旧版UI进行操作。

问题50：咨询SuperMap iServer产品是否支持将ArcGIS生成的紧凑型瓦片缓存（.bundle和.bundlx格式）作为数据源进行发布。

11.3.0 【解决办法】iServer不支持直接发布*.bundle + *.bundlx格式的ArcGIS紧凑型瓦片，支持的ArcGIS缓存类型可参考官方博客中的说明。参考链接：https://blog.csdn.net/Hallojian/article/details/127423181

问题51：客户网络中心监测到iServer服务存在可疑网络请求，怀疑是木马攻击。其中包含对/iserver/services/security/tokens等接口的访问以及一个经过双层Base64加密的字符串，需要确认其合法性并解密该字符串内容以供报告。

11.3.0 【问题原因】客户网络中心将iServer的正常鉴权接口请求及tunnels加密通信内容误判为木马攻击。 【解决办法】1. 确认/iserver/services/security/tokens等是iServer的正常鉴权接口。2. 解释了加密字符串是产品内置的tunnels加密，非木马行为。3. 通过本地环境演示加密解密过程，并提供截图，证明其为产品正常功能。

问题52：使用iServer的数据服务进行SQL查询时，不清楚如何构建针对日期（DateTime）类型字段的查询条件。

11.3.0 【解决办法】在构建SQL查询的where子句时，日期类型字段的条件值需使用单引号包裹的字符串，格式为'YYYY/MM/DD hh:mm:ss'。示例：UPDATETIME > '2026/04/10 00:00:00'。

问题53：咨询iServer发布的REST地图服务是否符合OGC标准。

11.3.0 【解决办法】明确告知用户，iServer的REST地图服务是超图自有的服务规范，并非OGC标准。如果需要OGC标准的服务，应在发布服务时勾选WMS、WMTS等OGC服务类型。

问题54：发布MVT矢量瓦片服务后，咨询如何获取和调用该服务对应的样式文件（style.json）。

11.3.0 【解决办法】通过在MVT地图服务的REST URL末尾直接追加/style.json即可访问和获取其样式配置文件。

问题55：iServer地理处理建模（GPA）中，使用“自动制图”算子时，如果不添加图层模板则运行正常；一旦为算子配置了图层模板，模型就会执行报错。

11.3.0 【解决办法】多个地图需要同等个数的地图模版一一对应，客户通过自定义扩展开发已完成需求

问题56：后端代码通过HTTP请求调用iServer GPA服务，在iServer升级到一个新版本后，之前正常的请求开始返回400错误。但在iServer自带的自动化处理界面或API工具中手动执行则无问题。

12.0.0 【问题原因】新版iServer对调用GPA服务的REST API要求更严格，HTTP请求头中的Content-Type不再兼容默认的application/x-www-form-urlencoded。 【解决办法】在后端发送HTTP请求的代码中，将请求头的Content-Type明确设置为application/json后，问题解决。

问题57：通过REST API调用iServer的GPA工具处理DWG数据，其中创建数据源的步骤失败。检查发现，代码中构造的CreateDataSourceDataConnInfo参数未能成功传递给工具，导致必填参数缺失。

11.3.0 【问题原因】在构建POST请求的JSON Body时，参数对象的键名Parameter首字母被错误地大写了。iServer的API对参数名大小写敏感，正确的键名应为parameter。 【解决办法】将请求体中的"Parameter"字段修改为小写的"parameter"，参数即可被正确解析。

问题58：在iDesktop中修改了地图样式（如关闭标签压盖），但发布为地图服务后，通过浏览器访问时发现地图缓存并未更新，显示的仍是旧的样式。

11.3.0 【问题原因】iServer的地图服务（WMS/RestMap）默认启用了缓存机制，当工作空间或数据更新后，缓存不会自动失效，需要手动清理。 【解决办法】在数据或地图样式更新后，需要调用iServer提供的REST API接口来清除指定地图或服务的缓存，从而使更新生效。

问题59：发布地图服务后，部分面图层的标签不显示，或在关闭流动显示后一个面要素出现多个重复的标签。

11.3.0 【问题原因】地图和图层级别的“允许标签完整显示”属性设置不当，导致服务出图时标签渲染逻辑出现异常。 【解决办法】在iDesktop中，关闭问题图层的“标签专题图-高级-允许标签完整显示”选项，同时开启地图的“属性-允许标签完整显示”选项，保存后重新发布服务。

问题60：iServer 11.3.0在Linux环境下创建三维服务提供者时失败，日志显示java.lang.UnsatisfiedLinkError，涉及libWrapjRealspace.so动态库加载问题。

11.3.0 【问题原因】缺少java组件运行许可导致报错 【解决办法】部署试用许可

问题61：咨询iServer产品是否支持将ArcGIS发布的REST海图服务（Maritime Chart Service）进行转发。

11.3.0 【解决办法】经与研发确认，虽然ArcGIS海图服务与普通地图服务都属于Map Service类型，但其内部出图规则不一致，因此当前版本的iServer不支持转发ArcGIS REST海图服务。

问题62：在iServer中执行自动化处理服务时，点击“取消”按钮后任务没有立即停止，执行状态长时间停留在0%，没有反应。

11.3.0 【问题原因】地理处理任务在执行密集计算或处于某个不可中断的阶段时，取消命令需要排队等待，直到当前操作完成或达到一个可中断的检查点时才能生效。 【解决办法】此为产品正常机制，耐心等待任务响应取消指令即可。

问题63：iServer地理处理服务中的任务执行失败，但是在任务详情结果中显示为空对象，且iServer日志中没有相关错误信息，导致无法排查问题原因。

11.3.0 【解决办法】针对地理处理服务（GPA）的专门日志进行排查。可以查看iServer安装目录下的 logs/geoprocessing_logs 文件夹中的GPA日志文件，以获取详细的执行过程和错误信息。

问题64：iServer中执行地理处理模型，上午执行成功，下午重新执行时任务卡在13%。重启服务后模型可执行完毕，但最终结果报错，怀疑是中间数据为空导致。

11.3.0 【问题原因】模型中的“计算流向”算子在处理边界数据时可能存在问题，导致后续流程出错。 【解决办法】在模型中找到“计算流向”算子，勾选其参数中的“强制对边界内插计算”选项，以确保边界数据能被正确处理。

问题65：使用SuperMap iDesktop 12版本创建并保存的工作空间，在SuperMap iServer 11版本中发布或浏览时出现报错，咨询是否是由于产品版本不兼容导致。

11.3.0 【问题原因】SuperMap GIS平台软件的工作空间文件格式存在版本兼容性规则，即高版本产品（如iDesktop 12）创建或保存的工作空间无法被低版本产品（如iServer 11）所兼容和解析。 【解决办法】确保服务端（iServer）的产品版本等于或高于桌面端（iDesktop）的产品版本。要发布由iDesktop 12制作的工作空间，必须使用iServer 12或更高版本。

问题66：部署修复漏洞的iServer新版本war包后，服务启动失败。经排查，原因为客户生产环境的操作系统（Linux）GLIBC和GCC库版本过低，与新版iServer依赖不兼容。

11.3.0 【问题原因】客户服务器系统库（GLIBC, GCC）版本过低，与新iServer的动态链接库依赖冲突。 【解决办法】通过一系列环境调整解决：1. 修改启动脚本，将JRE指向iServer自带的JRE。2. 通过 export LD_PRELOAD 强制使用系统的openssl库。3. 最终确认业务正常运行，遗留的遥感模块依赖警告因未使用该功能可忽略。

问题67：服务器开启防火墙后，iServer软件无法正常使用。咨询除了基础的Web访问端口（如8090），还需要开放哪些其他端口以保证软件功能完整。

11.3.0 【问题原因】服务器防火墙未开放iServer运行所需的所有端口，导致服务组件间通信受阻。 【解决办法】需在防火墙中开放以下端口：8090（iServer服务主端口）、8015（服务关闭管理端口）、8097（地理处理服务GPA端口）。如果使用的是文件型许可，还需开放1947端口。

问题68：用户咨询SuperMap iServer 10i产品是否存在某安全漏洞，并请求提供已修复该漏洞的最新Windows版本安装包。

11.3.0 【问题原因】用户使用的iServer版本存在安全漏洞。 【解决办法】该漏洞在新版本中已修复。为用户提供了修复该漏洞的iServer产品安装包下载链接，并指引其Windows版本可在历史版本2025M6-2中找到。

问题69：在Web端通过动态出图方式叠加图层时，发现图层加载顺序会影响标签的显示，后加载的区划标签会被先加载的镇街图层覆盖。

11.3.0 【问题原因】iServer的服务端缓存未关闭或浏览器缓存未清理，导致iDesktop中对地图专题图的修改（如标签设置）没有在前端实时生效。 【解决办法】在iServer管理页面关闭对应地图服务的缓存功能，并清理浏览器缓存后，重新加载地图即可看到正确的叠加和标签显示效果。

问题70：通过浏览器访问WFS 2.0服务时，返回XML解析错误，提示XML声明必须在文档开头、标签不匹配等问题。

11.3.0 【问题原因】WFS 2.0服务会将数据源别名作为XML的命名空间。当数据源别名以数字开头时，会生成不符合XML规范的命名空间，导致浏览器解析失败。 【解决办法】修改iServer中对应的数据源别名，确保其不以数字开头，然后重新访问服务。

问题71：使用WFS-T（Transaction）接口向服务中插入（Insert）一条新的面要素数据时，请求失败，返回内部服务器错误或提示非法字符。

11.3.0 【问题原因】1. 用户请求的WFS服务是基于只读数据源发布的，不支持写入操作。2. 用户构造的WFS-T请求XML报文中的面要素几何信息（coordinates）格式不正确。 【解决办法】1. 重新发布一个基于可编辑数据源的数据服务。2. 向用户提供了正确的WFS-T插入面要素的curl请求示例，用户基于该示例调整后验证成功。

问题72：系统中存在大量预览方案数据的需求，当前每次都发布新的三维、数据和地图服务，导致服务数量剧增，影响性能。咨询是否有更优化的服务管理和发布方案。

11.3.0 【解决办法】建议采用“单一工作空间，动态更新”的模式。即：发布一个基于数据库型工作空间的服务（包含地图、数据、三维服务），当有新数据需要预览时，通过代码将数据添加到该工作空间内的数据源和地图中，并保存工作空间。iServer服务会自动刷新，无需发布新服务，从而有效控制服务数量。

问题73：部署在内网的iServer服务，通过Nginx进行反向代理以供公网访问，但配置后始终无法成功访问，寻求正确的Nginx配置方案。

11.3.0 【解决办法】支持人员提供了一份经过验证的Nginx反向代理iServer的配置截图。建议用户参考该配置修改自己的nginx.conf文件，主要关注proxy_pass、proxy_set_header等关键指令的正确设置。

问题74：通过iServer集群地址（虚拟IP）上传大文件时操作失败。

11.3.0 【问题原因】前端请求经过Nginx反向代理，而Nginx默认对上传文件的大小有限制，导致大文件请求被Nginx拒绝，无法到达后端的iServer节点。 【解决办法】修改Nginx的配置文件（nginx.conf），在http或server段中设置client_max_body_size参数为一个更大的值（如client_max_body_size 1024m;），然后重载Nginx配置使其生效。

问题75：将存储在金仓（KingbaseES）数据库中的数据源通过iServer发布为地图服务后，在客户端访问该服务时，地图上的图形要素无法正常显示。

11.3.0 【问题原因】使用了之前的错误镜像。 【解决办法】更新最新镜像后问题解决

问题76：使用iDesktopX生成的矢量瓦片（MVT），无论是原始型还是紧凑型，在iServer中发布服务时均失败。无论是从桌面直接发布，还是在iServer管理页面上传发布，都无法成功。

12.0.1 【问题原因】客户的iServer存在问题,本地拿客户数据发布没有问题。 【解决方案】更新iServer之后客户那边可以成功发布了

问题77：通过接口向数据库型工作空间添加新地图后，iServer中对应的地图服务并未实时更新，导致前端访问新地图时出现404错误，服务内容不稳定，时有时无。

11.3.0 【问题原因】问题根源在于数据中心调用组件更新数据库工作空间的方式存在逻辑缺陷，导致地图资源被异常删除或未正确保存，并非iServer产品问题。 【解决办法】问题已定位为数据中心应用层代码问题，并转交由数据中心开发同事进行排查和修复。

问题78：为实现影像数据的自动化更新，调用iServer影像服务的REST API（DELETE方法）删除影像时，返回“没有编辑权限”的错误。同时，用户希望了解如何高效地查询到待删除影像的ID，以及删除后是否需要重建缓存。

11.3.0 【问题原因】1. iServer中对应的影像服务未勾选“允许编辑”选项，导致DELETE请求被拒绝。2. 未使用正确的查询参数获取影像ID。 【解决办法】1. 在iServer服务管理页面，勾选对应服务的“允许编辑”权限。2. 使用search.json接口，并结合query=SmFileName=''参数进行精确查询或模糊查询来获取影像ID。3. 接口删除后不会自动更新缓存，需要手动重建瓦片。

二、SuperMap iDesktopX

问题1：iDesktop 2025连接瀚高4.5安全版数据库（sm3加密）时，创建PostGIS数据源一直失败。

12.0.0 【问题原因】用于新建数据源的数据库用户不具备数据库超级管理员权限。 【解决办法】更换为具有数据库超级管理员权限的用户进行操作即可成功新建数据源。

问题2：咨询iDesktop的高级制图插件功能，在新版iDesktopX中对应哪个版本或功能模块。

11.3.0 【解决办法】需要标准版及以上许可

问题3：项目部署了地籍管理系统V6.1.0.0，咨询如果使用12i的桌面和11i的iServer，版本不匹配是否会有问题。

12.0.0 【解决办法】建议使用相同大版本的桌面和iServer产品，因为不同大版本之间功能有新增和优化，混用可能导致兼容性问题。

问题4：在iDesktopX中新建PostgreSQL数据库型数据源时，登录的用户是否必须是数据库的超级管理员用户。

11.3.0

【解决办法】普通用户要有所有sm开头表格的增删改查权限 然后对空间数据设置查看的权限 就能实现在idesktopx上用普通用户打开并查看pg数据库的数据

问题5：对OSGB格式的Mesh数据生成配置文件时，软件闪退，操作失败。

11.3.0 【问题原因】数据有问题导致了软件闪退 【解决办法】进行了倾斜数据预处理后，发现有个文件的纹理超限，将该文件移除

问题6：咨询超图三维产品对VR设备的支持情况，特别是对Oculus设备的具体型号，以及经过产品测试的设备有哪些。

11.3.0 【解决办法】目前iDesktopX和组件产品支持的VR设备是Oculus Rift DK2。

问题7：在人大金仓数据库（PG模式）中，使用iDesktopX 12i修改数据集名称后，iDesktopX中显示修改成功，但数据库中的实际表名未被修改。

12.0.0 【解决办法】在“文件-选项-环境”处勾选“数据集名与表名保持一致”，或者使用工具箱中“重命名数据集”同时勾选“重命名表名”即可

问题8：iDesktop工作空间中的地图配色方案，在sxwu文件中存储的颜色值与在桌面软件界面看到的RGB值不一致，咨询两者间的映射关系。

11.3.0 【问题原因】因为以前的版本还不直接支持alhpa，都是用1,2,3的rgb值模拟透明的，那个时候存储的颜色值就只有三位。为了双向兼容才这么设计的 【解决办法】可以用1 x 65535 + Alhpa x 256 + Blue这个公式去计算B值

问题9：在人大金仓数据库中，将数据导入到指定schema下后，形成的"schema@数据集名"格式的数据集无法通过右键或工具进行重命名。

11.3.0 【解决办法】在数据库中修改对应表名，同时修改smregister表中对应的smdatasetname和smtablename字段即可。

问题10：咨询在iDesktop中，是否可以实现对矢量数据进行质检（拓扑、属性检查），检查无误后自动入库的全流程自动化操作。

11.3.0 【解决办法】用gpa自动化工具可以实现，例如拓扑检查工具

问题11：咨询是否有方法可以从倾斜摄影模型中提取出二维的面数据，并用于计算面积。

11.3.0 【解决办法】可以使用倾斜提取DSM或者DOM，然后提取轮廓面。可以参考下技术小视频：https://weixin.qq.com/sph/AORpiCcpe

问题12：咨询在iDesktopX中是否可以实现一种特殊的文本注记效果，即注记内容为上下结构，且下半部分文字为斜体。

11.3.0 【解决办法】可以实现。通过在文本风格设置中使用换行符和富文本表达式，可以为不同部分的文本设置不同的样式（如斜体参考帮助文档：https://help.supermap.com/iDesktopX/zh/tutorial/Mapping/TextExpression.html

问题13：一个未设置密码的工作空间文件，在正常编辑保存后，再次打开时却提示需要输入密码。

11.3.0 【解决办法】已经损坏的工作空间没办法再恢复，可以找下C:\Users\PC\AppData\Roaming\SuperMap\iDesktop目录有没有临时保存的工作空间，或者新建工作空间重新导入数据源

问题14：在iDesktopX中对一个模型数据集修改了材质颜色，单独生成缓存时颜色正确。但将其与其他模型合并生成缓存时，该模型的颜色会变回白色。

11.3.0 【问题原因】模型的材质不一样，但是材质名称相同 【解决办法】修改材质名称为不同的名字即可

问题15：咨询如何使用iDesktopX 2025将TIF格式的DEM数据处理成S3M 3.01版本的三维地形瓦片，并希望提供教程文档。

12.0.0 【解决办法】数据集右键直接生成三维瓦片

问题16：连接PostGIS数据库时，即使在连接参数中指定了特定的schema，打开数据源后依然会加载出所有schema下的空间数据表。

11.3.0 【问题原因】产品设计如此，会读取所有用户有权限访问的数据集，非指定schema下的数据集会以“schema@数据集名”的形式显示。 【解决办法】如果希望只显示指定schema下的数据集，需要通过数据库权限管理，取消用户对其他schema下数据的读取权限。

问题17：使用瓦片管理工具读取存储在MongoDB中的瓦片时，地图显示全白，但数据库连接正常，数据本身无问题。

11.3.0 【问题原因】打开瓦片时，图层默认不显示 【解决办法】在图层管理器打开显示

问题18：lod1.3级别的三维模型（原始为obj格式）导入到udbx数据源后，出现纹理丢失，模型全部显示为黑色。

11.3.0

【问题原因】导入obj模型功能使用错误 【解决办法】使用【工具箱】-【导入OBJ】算子进行导入

问题19：导入一个包含21万对象的SHP文件时耗时较长，咨询是否有方法可以缩短导入时间。

11.3.0 【解决办法】改用 GPA 大数据算子导入 shp 数据，单机情况下使用 local 多进程。

问题20：iDesktop连接瀚高（HighGo）数据库后，创建数据源失败，报错缺少SM系统表。使用“修复数据源”工具也失败，提示不是SuperMap数据源。

11.3.0 【解决办法】用户权限不足，需要授予管理权限

问题21：使用倾斜摄影数据入库功能生成S3M缓存，任务执行完成后，在输出目录中没有找到对应的scp配置文件。

11.3.0 【解决办法】经客户的机器测试，小数据是正常的生成的，但是客户的数据量有1t，建议客户分批进行重新入库

问题22：在使用iDesktopX的GPA工具串联栅格分析算子时，发现很多栅格分析相关的算子无法输入行内变量，咨询是功能限制还是操作错误。

11.3.0 【解决办法】现有的功能直接串联无法实现，可以通过绕行方案实现想要的需求： 打开数据集—核密度分析——重分级——提取指定面—按条件删除对象。

问题23：在iDesktopX中，对人大金仓数据库中的数据集分组或数据集本身进行重命名操作时失败，咨询需要为数据库用户授予哪些权限。

11.3.0 【问题原因】权限不足。在人大金仓数据库中，对数据集的父分组进行修改操作，要求操作用户必须是超级用户或者是该数据集的所有者。 【解决办法】使用超级用户或数据集所有者用户进行重命名操作。

问题24：使用圆周率加密工具加密的IMG格式影像数据，在已运行解密软件的情况下，仍然无法在桌面软件中正常打开。

11.3.0 【解决办法】得购买加密软件的单位，同意把超图的软件加入白名单，圆周率单位再给对应的补丁包，才可实现影像在超图软件中打开。

问题25：使用iDesktopX生成矢量瓦片后，在地图上进行浏览时，瓦片边缘或特定区域出现了不应有的黑色块状区域，影响显示效果。

11.3.0

【解决办法】矢量瓦片不支持专题图过滤，可以将数据重新处理，生成一个新的数据集，不包含为空的这些数据，再用新数据集配图

问题26：咨询iDesktopX在导入GDB数据时的功能：1. 是否能直接导入到指定的数据集分组中？ 2. 导入时是否能选择使用要素类的别名作为新表名？

11.3.0 【解决办法】1. 导入GDB时，如果GDB数据本身存在分组，产品支持保留原有的分组结构导入。 2. 目前产品暂不支持读取GDB中数据集的别名作为表名。可以考虑在数据导入完成后，再进行数据集的名称调整。

问题27：在iDesktop中，镶嵌数据集在图例中默认只显示为一个条目。咨询如何修改图例，使其能够显示镶嵌数据集中每一个组成影像的名称。

11.3.0 【问题原因】产品默认图例不支持展开显示镶嵌数据集的所有子项。 【解决办法】此需求需要通过二次开发实现。可以在前端通过数据服务查询镶嵌数据集的属性表，获取其中包含的TIF/ITF文件名称列表，然后自定义生成图例。

问题28：在iDesktop中使用“三维模型拆分”功能时，拆分后的部分子模型对象发生了位置偏移，并且丢失了原有的材质贴图。

11.3.0

【问题原因】原始数据为投影坐标系，且模型呈长条形，地理跨度较大，拆分为子对象后，在自动投影转换过程中产生了偏差。 【解决办法】先对原始模型数据集进行投影转换，将其转换为地理坐标系，并在此过程中勾选“模型转换顶点”选项，然后再执行模型拆分操作。

问题29：生成矢量瓦片后，sprite.png文件中的配图样式相对于桌面的配图样式少一部分怎么解决？

11.3.0

【问题原因】符号的背景是透明的，只有边框，在sprite.json只显示填充符号，所以看不到，并不是配图样式少了。还有一个符号是填充符号太小，在图例里看不清楚。 【解决办法】使用其他符号或者将填充符号放大

问题30：iDesktopX 12.0.1版本存在两个问题：1.模型瓦片局部更新功能，按范围更新时存在问题；2.生成的地形缓存在场景中浏览时，即使开启了深度优化和地形裙边，仍会出现黑白缝隙。

12.0.1

问题一 【问题原因】该问题为双周包缺陷 【解决办法】最新双周包已解决，链接：https://pan.baidu.com/s/1ItJgSorI4iYX_rXm85Xdgw 提取码: bxi6 问题二 【问题原因】地形裙边虽然开启了，但是未设置数值 【解决办法】提高裙边高度避免缝隙

问题31：iDesktopX的出图效果在小比例尺下，图斑粘连，不如QGIS清晰。尝试调整“显示完整线型”和取消“抽稀显示”均无效。

12.0.1

【问题原因】桌面会将图斑中的缝隙进行补绘 【解决办法】在xml里面新增了一个参数<DrawPolygonLine>控制是否补绘，配置为false即可 链接：https://pan.baidu.com/s/1ItJgSorI4iYX_rXm85Xdgw 提取码: bxi6

问题32：咨询在没有可视化界面的Linux服务器上（只能通过Web端登录）是否可以正常使用iDesktopX。客户环境为腾讯云上的Linux服务器，无桌面环境。

11.3.0 【问题原因】iDesktopX是桌面端GIS软件，其运行依赖于操作系统的图形用户界面（GUI）。 【解决办法】为Linux服务器安装带可视化界面的桌面环境，即可正常使用iDesktopX。

问题33：咨询在iDesktop桌面端如何生成MVT矢量瓦片，以及生成的MVT瓦片服务是否能以WMTS标准发布。

11.3.0 【解决办法】1. 在iDesktopX中，通过“多任务切图”功能，在瓦片类型中选择“矢量瓦片”即可生成MVT格式的瓦片。 2. iServer发布的MVT服务遵循Mapbox矢量瓦片规范，但不能以OGC WMTS服务的形式发布。

问题34：使用iDesktopX的瓦片检查功能时，当瓦片数据源为MongoDB时，执行检查任务失败，咨询导致失败的具体原因。

11.3.0 【问题原因】在瓦片检查功能的操作面板中，未设置“检查报告”的输出路径。 【解决办法】为“检查报告”参数指定一个有效的本地文件保存路径后，即可正常执行检查任务。

问题35：在iDesktopX中生成矢量瓦片时，期望使用自定义的比例尺和瓦片原点，以对接部委标准。但在操作中，设置自定义参数后生成的瓦片在地图上显示为空白。

12.0.0 【问题原因】用户提供的0级比例尺和自定义原点参数，与iDesktopX默认的DPI（96）计算出的全球剖分范围不匹配，导致地图数据不在切图范围内，从而生成了无内容的空瓦片。 【解决办法】将切图的0级比例尺设置为符合OGC WMTS标准（DPI 90.714）的279,541,132.0144，并从0级开始切图，即可正常生成数据。

问题36：用户获取了iDesktopX 12版本的文件许可，但不清楚应将该许可文件放置于哪个目录才能使软件正常激活。

12.0.0 【解决办法】对于Windows系统，iDesktopX的文件许可需要放置在C:\Program Files\Common Files\SuperMap\License\目录下。不同版本的文件许可可以同时放置在该目录中，产品会根据版本自动查找匹配的许可。

问题37：用户在使用iDesktopX时，无法在工作空间中加载天地图数据源，报错日志与网络请求相关。该问题发生在客户的前置机环境中，尽管已为天地图服务开通网络权限，但使用自定义或默认Token均加载失败，最终定位为客户环境网络不通导致。

11.3.0 【问题原因】客户的前置机网络环境无法访问天地图WMTS服务的外网地址。通过浏览器直接访问服务URL（http://t0.tianditu.com/vec_w/wmts?...）失败，验证了是网络连接问题导致，而非产品本身问题。 【解决办法】请客户联系其网络运维人员，排查并解决客户端到天地图服务地址的网络连通性问题，确保能够正常访问外网服务。

问题38：在iDesktopX中，当尝试将一个特定的面数据集导出为File Geodatabase (.gdb) 或Shapefile (.shp)格式时，桌面软件会立即崩溃。

12.0.0 【问题原因】数据集中存在一条SMID为10660的记录，其几何对象为空。iDesktopX在执行导出操作时，未能正确处理这种空几何的异常数据，从而导致程序崩溃。 【解决办法】在导出前，对数据集进行检查，将几何对象为空的记录筛选出来并删除。删除这些异常数据后，即可正常执行导出操作。同时，此问题已作为产品缺陷提单，将在后续版本中进行优化。

问题39：在Linux环境下，最新双周版的iDesktopX（deb格式安装包）启动时反复闪退。通过终端启动，日志显示有两项权限不足的错误，即使使用root用户也无法启动。

11.3.0 【问题原因】环境兼容问题。 【解决办法】将\support\browser目录下的一个sh脚本删除后，iDesktopX可正常启动和使用。

问题40：用户反馈桌面端软件无法获取许可授权，导致无法使用。该软件去年曾正常使用，当前尝试激活试用许可失败，并提示错误。

11.3.0 【问题原因】环境变量中计算机名称和系统页面显示的计算机名称不一致 【解决办法】以管理员运行PowerShell 使用如下命令更改一下计算机名称.Rename-Computer -NewName "你想要的新名称" -Force。新名称 是许可文件中的计算机名更改后已解决

问题41：在部分旧版本的超图桌面软件中，地图中的注记图层无法正常显示，咨询问题原因及解决办法。

11.3.0 【问题原因】该问题可能是旧版本iDesktopX产品中存在的缺陷所导致。 【解决办法】建议升级并使用较新的11.3.0版本的iDesktopX产品，该版本已修复此问题。

问题42：咨询桌面产品SuperMap iDesktopX是否有适用于苹果macOS操作系统的版本。

11.3.0 【问题原因】用户咨询iDesktopX产品的操作系统支持情况。 【解决办法】明确告知用户，SuperMap iDesktopX产品目前仅支持Windows和Linux操作系统，没有提供macOS版本。

问题43：用户在安装了新版本的iDesktopX修复包后，尝试更新许可文件时失败，无法成功应用新的授权，导致软件无法打开。

11.3.0 【问题原因】许可目录下（C:\Program Files\Common Files\SuperMap\License）存在多个旧的或许可冲突的许可文件，导致新许可无法正常加载。 【解决办法】清理许可目录下的其他无关或许可文件，只保留最新有效的许可文件。

问题44：使用iDesktopX连接人大金仓（PG内核）数据库时：1. 使用kingbase类型连接无法写入数据（导入/复制/新建）；2. 使用postgreSQL类型连接，数据被写入sdx模式而非public模式。

12.0.0 【问题原因】1. 使用Kingbase连接方式打开PostgreSQL数据源，产品设计为只读模式。2. 使用PostgreSQL数据源类型新建时，系统表和数据默认存储在sdx模式下。 【解决办法】1. 若需写入数据，应使用iDesktopX新建一个Kingbase数据库型数据源。2. 若需将数据存储在public模式，应在数据库中安装PostGIS扩展，并使用PostGIS数据源类型连接。

问题45：在iDesktopX中，连接File GDB类型的数据源后，右键菜单中没有“新建数据集”的选项，无法在GDB数据源中直接创建新的数据集。咨询该功能是否受支持。

12.0.0 【问题原因】产品设计如此，iDesktopX目前不支持直接在File GDB数据源中创建新的数据集。 【解决办法】该功能为产品当前限制。支持新建数据集的数据源类型包括UDBX、PostGIS、OraclePlus等，但不包含File GDB。用户需在其他支持的数据源中创建数据集。

三、SuperMap iDesktop

问题1：使用iDesktop进行三维模型生成缓存时，切片进度条长时间停留在88%，无法完成。咨询此现象是否正常，以及如何判断和处理。

11.3.0 【问题原因】数据中存在结构复杂的对象【解决办法】通过【操作子对象】功能简化该复杂对象，后生成三维瓦片正常

问题2：使用iDesktop新建PostgreSQL数据源时，首次操作长时间无响应，强制关闭后再次尝试则直接报错“创建失败”。

11.3.0 【解决办法】初步判断，首次创建数据源失败可能在数据库中残留了不完整的超图系统表（以'sm'开头）和序列。清理这些残留表后，数据源可以成功创建。

问题3：用户在iDesktop中导入BIM模型时，对“旋转角”参数的定义不明确，询问设置的旋转角是顺时针为正还是逆时针为正。

11.3.0 【解决办法】在iDesktop导入BIM模型时，设置的旋转角是指模型绕数据原点，与正北方向的夹角，方向为逆时针。

问题4：咨询如何在倾斜摄影模型上进行挖方、找平，并添加水面或草坪等三维特效的操作流程。

11.3.0 【解决办法】1. 在iDesktop中，基于倾斜模型表面绘制三维面状对象。2. 在图层管理器中右键单击该三维面图层，设置其图层风格。3. 在符号库中选择水面或草地等三维材质赋予该图层。4. 将场景生成三维缓存后发布服务。技术支持同时提供了一个包含相关操作的教学录屏视频。

问题5：在iDesktop中使用人大金仓（Kingbase）数据库数据制作单值专题图时，软件界面长时间卡顿，超过30分钟无响应。

11.3.0 【问题原因】通过查看iDesktop日志，发现执行数据库SQL查询耗时过长，是数据库端性能瓶颈导致了桌面软件卡顿。 【解决办法】建议检查并清理数据库端的闲置会话，优化数据库资源占用情况，提升数据库查询性能。

问题6：在iDesktop中导入CAD数据时，由于坐标不正确，需要使用“指定坐标点”的方式进行配准，但不清楚如何在界面中输入目标坐标值。

11.3.0 【解决办法】在“指定坐标点”的交互状态下，当鼠标移动到目标位置并点击后，按键盘上的Tab键，即可弹出坐标输入框，手动输入精确的坐标值。

问题7：使用iDesktop的地图切片功能时，发现生成的瓦片地图与原始影像相比不够清晰，咨询如何设置参数以提高显示效果。

11.3.0 【解决办法】为提升瓦片清晰度，可以从三方面进行调整： 1. 瓦片格式：推荐选用WebP格式，压缩率和质量较优。 2. 压缩比例：将默认的75适当调高，可提升图像质量，但需兼顾生成文件大小。 3. 分辨率：适当提高DPI值，可提升瓦片输出的精度，但需注意会改变切图比例尺。

问题8：在iDesktop中使用线状地物生成的面状缓冲区对三维模型进行裁剪时，发现裁剪结果为空，没有任何模型数据被保留下来。

11.3.0 【问题原因】用户使用的iDesktop版本中，三维模型裁剪功能存在缺陷，处理特定数据时会导致裁剪失败，返回空结果。 【解决办法】升级iDesktop产品到问题已修复的新版本（如聊天中提到的“管网2026版本”），使用新版本软件执行相同的裁剪操作即可得到正确结果。

问题9：服务器意外断电关机，咨询iDesktop中正在执行的地图瓦片切图任务是否可以恢复，以及如何操作。

11.3.0 【解决办法】在iDesktop的地图瓦片生成工具中，重新加载原始的切图任务配置文件，然后在生成选项中勾选“续切”选项。程序会自动检测已生成的瓦片，并从上次中断的位置继续执行切图任务。

问题10：使用iDesktop对三维模型进行面裁剪时，特定区域的模型无法被裁剪，或者裁剪结果不完整，仅保留了边界部分，中间区域为空洞。

11.3.0 【问题原因】被裁剪的三维模型本身存在拓扑错误，如模型面片间存在裂缝、未焊接顶点等。当裁剪范围的边界线与模型的这些拓扑错误位置相交时，裁剪算法无法正确闭合裁剪面，导致裁剪失败或结果异常。 【解决办法】在执行裁剪前，需要先修复模型的拓扑错误。可使用专业三维建模软件（如3ds Max、Blender）或iDesktop的模型修复工具对数据进行检查和修复。

问题11：在iDesktop中对面图层设置多字段组合标注，并启用了自动换行功能。部分标签未按设定的字符数换行，或出现单字成行的情况，显示效果不佳。

11.3.0 【问题原因】标签表达式中的显式换行符chr(10)与专题图的“超长处理-自动换行”功能组合使用时，其渲染逻辑不符合用户的预期效果。 【解决办法】在标签专题图高级设置中，不使用“超长处理”，而是完全通过标签表达式，结合chr(10)换行符和Substr字符串截取函数来手动控制换行逻辑，实现精确的换行效果。

问题12：在iDesktop中处理OBJ单体模型时，软件提示缺少关联的纹理贴图文件，但检查后发现文件实际存在。

11.3.0 【问题原因】导入OBJ模型时报错提示文件不存在，是由于OBJ关联的.mtl材质文件中记录的纹理贴图路径不正确，或模型与贴图的相对路径发生了改变。 【解决办法】使用文本编辑器打开.mtl或.obj文件，检查并修正其中引用的纹理图片路径，确保程序能根据该路径找到对应的贴图文件。

问题13：咨询在SuperMap iDesktop中，如何将一个普通的二维线数据集，转换为能够进行路径分析的网络数据集。

11.3.0 【解决办法】在iDesktop软件中，可以利用“交通分析”功能模块下的“拓扑构网”工具，将指定的二维线数据集构建为具备拓扑网络结构的网络数据集。

问题14：在iDesktop的布局窗口中，如何调整地图框内显示的地图范围和比例尺，以控制最终出图的内容区域？

11.3.0 【解决办法】在布局窗口中，在地图框对象上单击鼠标右键，在右键菜单中取消勾选“锁定地图”。取消锁定后，即可使用鼠标滚轮缩放、左键拖动来平移和调整地图框内的地图显示范围。调整完毕后建议重新锁定。

问题15：在iDesktop中，将标签专题图（特别是沿线标注）转为CAD文字或文本数据集时，部分标签未能成功转换，导致注记丢失。

11.3.0 【解决办法】1. 在转换前，分别在地图属性和专题图属性中，调整与标签避让、重叠检测相关的设置，以显示尽可能多的标签。 2. 执行转换操作。对于仍然无法转换的标签（通常是复杂的沿线标注），可将其单独导出一个新图层，取消其“沿线标注”属性，使其变为普通点状注记后再次尝试转换。

问题16：用户咨询在iDesktop布局视图中，由多个对象组成的复合对象是否支持复制和粘贴操作。

11.3.0 【解决办法】经测试验证，iDesktop布局中的复合对象支持标准的复制和粘贴操作。

问题17：咨询SuperMap桌面和服务器产品是否支持连接PostGIS只读数据库，并读取非'public'的自定义Schema下的空间数据表。用户反馈其使用的旧版本桌面端似乎只能读取'public' Schema。

12.0.0 【问题原因】旧版本桌面产品在连接PostGIS数据源时，可能未提供或未突出显示指定Schema的选项，导致用户误认为只能读取默认的'public' Schema。 【解决办法】使用SuperMap iDesktop 12.0.0及以上版本。在新建PostGIS数据源的连接设置界面中，可以手动指定要连接的Schema名称，从而成功读取到自定义Schema下的空间数据表。

问题18：咨询如何将SHP文件的属性，批量挂接到对应的三维模型（OBJ导入后）上。

11.3.0 【解决办法】在iDesktop中，若要将一个矢量数据集（如SHP导入后）的属性挂接到模型数据集上，可通过“数据”选项卡下的“追加列”功能实现。前提是两个数据集中必须有一个能够关联的公共字段。该操作会将属性字段及值追加到模型数据集的属性表中。

问题19：用户将一个DGN格式的BIM模型导入iDesktop后，数据源中只生成了点数据集，没有生成对应的模型数据集，导致无法看到三维模型。

11.3.0 【问题原因】为加快导入速度，iDesktop将BIM数据中重复的模型实体处理为点数据集（外挂模型）。 【解决办法】使用“点集生成瓦片外挂模型”功能，对导入的点数据集生成模型缓存后，即可在三维场景中正常显示。

问题20：用户在三维场景中为图层配置风格，但实际显示的颜色与配置的颜色存在明显色差，不一致。经过多次尝试调整符号库中的颜色或新建符号，问题依然存在。

11.3.0 【解决办法】先在地图中配置单值专题图，将设置好风格的图层生成栅格瓦片（缓存），再将生成的瓦片加载到三维场景中，颜色即可正常显示。

问题21：在国产龙芯（Loongson）操作系统上安装了超图产品包，但在其support目录下未找到许可驱动程序，无法安装许可，咨询是否是安装包有问题。

11.3.0 【问题原因】超图GIS平台产品在龙芯（Loongson）架构下不支持安装硬件许可驱动，因此产品包内不包含许可驱动安装程序。 【解决办法】龙芯平台下需使用文件型许可（.lic7r格式）。将获取到的许可文件直接放置在产品的指定许可目录（通常为 /opt/SuperMap/License）下即可，产品启动时会自动读取并激活。

问题22：在iDesktop的布局视图中，发现拖动调整地图框大小时，地图的边框（Map Frame）大小保持不变，未与地图内容区域同步缩放，导致二者分离。

11.3.0 【问题原因】用户在布局中误放置了两个重叠的地图对象：一个有边框，一个无边框。用户实际操作的是上层无边框的地图对象，因此下层有边框的地图对象并未发生变化。 【解决办法】在布局对象管理器中删除多余的地图对象，只保留一个进行操作即可。

问题23：追问之前提到的“追加列”功能，在iDesktop软件中的具体菜单位置和操作入口。

11.3.0 【解决办法】iDesktop中“追加列”功能的具体位置在：功能区“数据”选项卡 -> “数据处理”组 -> “追加列”。

问题24：使用iDesktop导入一个包含多个独立模型的OBJ文件时，所有模型被合并成了一个单一对象，咨询如何将其按独立模型导入。

11.3.0 【问题原因】使用了通用的“导入数据集”功能，该功能默认将单个文件视为单个对象。 【解决办法】应使用专门的BIM/模型导入工具：在“三维数据”选项卡 -> “模型”组 -> “导入模型（OSGB/OBJ等）”。该工具能够识别OBJ文件内部的独立对象结构，并将其作为多个独立对象导入到模型数据集中。

问题25：针对上一个问题，如果有数百个存放OBJ文件的文件夹需要处理，咨询是否有批量导入并创建为独立模型的方法。

11.3.0 【解决办法】若要批量导入多个文件夹下的OBJ文件，可使用iDesktop的地理处理建模（GPA）功能。通过构建一个模型，使用“迭代文件”算子遍历所有OBJ文件，再将迭代出的文件路径作为“导入模型（OSGB/OBJ等）”算子的输入，即可实现全自动化批量处理。

四、SuperMap iObjects Java

问题1：咨询GPA算子是否支持二次开发，以及是否有相关的文档或视频教程。

11.3.0 【解决办法】支持扩展GPA算子。可以参考乐享平台的内部文章，其中详细介绍了如何进行GPA算子的扩展开发：https://lexiangla.com/teams/k100048/docs/b129ce9886aa11efa21fd6b263b517c1

问题2：使用iObjects Java组件通过recordset.addNew方法向空间数据库写入数据时，部分字段写入失败。代码执行日志显示待写入的字段值是完整的，但最终入库后数据表中对应字段的值为空。

11.3.0 【解决办法】代码中的字段属性和数据库属性不匹配，修改一致后问题解决

问题3：iObjects for Java包在调用时出现java.lang.UnsatisfiedLinkError，具体报错方法为com.supermap.data.EnvironmentNative.jni_GetBasePath。

11.3.0 【问题原因】iObjects Java 组件的环境变量未正确设置，导致应用无法加载到所需的本地库（.so/.dll文件）。 【解决办法】在Linux系统中，通过执行export LD_LIBRARY_PATH=SuperMap iObjects Java安装目录/Bin/:$LD_LIBRARY_PATH命令，将组件库路径添加到系统环境变量中。

问题4：使用iObjects组件制作标签专题图（ThemeLabel），当地图缩放时，部分标签会因为避让或重叠关系而不显示，希望能让所有标签一直保持显示。

11.3.0 【问题原因】标签专题图默认开启了避让策略，在不同比例尺下会自动隐藏重叠的标签以保证显示清晰。 【解决办法】可以通过设置标签文本风格的setSizeFixed(true)属性，使其“随图缩放”。另外，也可以通过调整专题图的setOverlapAvoided(false)属性来关闭标签避让。技术支持已提供修改后的示例代码文件供参考。

问题5：应用从旧版本升级至iObjects Java 12.0.0后，在Linux环境下启动服务报错，日志显示UnsatisfiedLinkError，对数据集进行查询操作也失败。

12.0.0 【问题原因】iObjects Java 12.0.0正式版产品包中可能存在动态链接库不完整或兼容性问题，导致在特定Linux环境下无法正确加载。 【解决办法】更换为更新的iObjects Java 12.0.1双周内部测试版后，启动和服务查询功能均恢复正常。

问题6：在K8S容器内部署iObjects Java组件，验证试用许可正常，但验证正式许可时返回错误码5007（模块对照ID不正确），后续在创建许可实例对象时直接发生异常。

12.0.1

【问题原因】许可验证代码与运行版许可不匹配。 【解决办法】验证许可的时候需要根据当前所使用的许可版本选择对应的type，如开发许可选择IOBJECTS_CORE_DEVELOP，运行许可选择IOBJECTS_CORE_RUNTIME

问题7：咨询在iObjects for Java中，如何为点数据集设置三维点符号（如图标或模型），并生成S3M场景缓存，期间遇到Maven依赖、代码报错及模型符号不显示等问题。

11.3.0 【问题原因】初期代码实现方式有误，以及对符号库和模型文件的调用API理解不清晰。 【解决办法】支持人员提供了关键示例代码，明确了正确的使用方式：需在工作空间中打开或导入符号库资源，然后在Layer3DSettingVector中设置图层风格GeoStyle3D，并通过setMarkerSymbolID方法指定资源库中符号的ID，最后通过SceneCacheBuilder生成缓存。

问题8：在解决iObjects Java 12i版本问题后，需要配套的ARM架构版本的iObjects Java 12.0.1双周包。

11.3.0 【解决办法】技术支持提供了对应ARM版本的iObjects Java 12.0.1双周包的网盘下载链接。

问题9：用户使用iObjects Java进行交通网络分析，获取了最佳路径上的所有结点ID，但不清楚如何将这些ID与实际的站点名称关联起来。

11.3.0 【解决办法】1. 交通网络分析返回的结点ID（nodesIDs）即为网络数据集节点表中的SmNodeID字段值。2. 以获取到的SmNodeID作为查询条件，去查询原始的站点数据集，即可获取到对应的站点名称等详细属性信息。

问题10：使用iObjects Java组件开发服务，通过代码连接PostgreSQL模式下的工作空间后，无法获取到地图列表，而工作空间中实际存在地图。

11.3.0 【解决办法】当时没有写工作空间名，引起连接失败

问题11：使用iObjects组件，希望通过代码获取栅格数据集的单元格大小，即其X、Y方向上的分辨率。

11.3.0 【解决办法】目前没有直接的接口获取分辨率。需要通过栅格数据集的范围（Bounds）和尺寸（Width/Height）手动计算： Y方向分辨率 = (范围上边界 - 范围下边界) / 栅格高度 X方向分辨率 = (范围右边界 - 范围左边界) / 栅格宽度

问题12：在iObjects组件应用程序中，如何通过代码判断最终用户的电脑上是否已经安装并激活了超图的许可？

11.3.0 【解决办法】1. 程序化判断：在代码初始化SuperMap环境（如Workspace.setLicensePath）的逻辑块中，使用try-catch语句捕获异常。如果未能找到有效许可，程序会抛出与许可相关的特定异常，通过捕获该异常即可判断。 2. 手动检查：在Windows环境下，可以引导用户打开“超图许可中心”程序进行查看。

问题13：iObjects Java应用程序在初始化时报错，日志显示许可模块验证失败。更换了多个版本的许可，问题依旧。

11.3.0 【问题原因】在许可文件存放目录（C:\Program Files\Common Files\SuperMap\License）中，存在一个旧版本的许可文件（.licx），新版许可驱动程序未能正确移除或覆盖它，导致程序启动时优先读取了无效的旧许可。 【解决办法】手动删除或许可目录下的所有旧许可文件，只保留当前版本对应的有效许可文件，问题即可解决。

问题14：基于iObjects Java 10i开发的应用部署到无显卡的Linux服务器时，调用三维模型处理相关接口失败。部署过程先后解决了系统库缺失、环境变量配置和许可配置问题，但最终卡在硬件依赖上。

10.2.1

【问题原因】iObjects Java的三维功能（如模型生成缓存）依赖于底层的图形库（如OpenGL），而这些图形库的运行需要服务器具备GPU硬件支持。部署的目标服务器没有显卡，无法满足运行环境要求。 【解决办法】 在10i版本在linux下面去对模型切瓦片或者是对倾斜做入库都是需要显卡的，这个在后续11i和12i版本中产品进行了适配，由于目前10i已经过了产品的生命周期，如果需要在linux无显卡环境下对模型或倾斜做切片操作建议升级产品到11.3或者12i。

问题15：使用代码进行数据集空间查询时，返回的结果集不完整，部分数据丢失。后端服务报错“row number -1 is out of range 0..-1”。

11.3.0

【问题原因】在对数据集做空间查询时，同时设置了过滤条件 【解决办法】把查询和过滤步骤拆分成两步进行，先空间查询，然后再对空间查询的结果数据进行过滤。

问题16：基于iObjects Java和Spring Boot开发的应用启动失败，日志中出现 hasp_container_not_found 和 verifyLicense 等错误，怀疑是许可授权问题。

11.3.0 【问题原因】错误日志中的 hasp_container_not_found 明确指出应用程序未能找到有效的SuperMap许可。 【解决办法】将有效的许可授权文件（如.lic文件）放置在应用程序可以访问的指定目录下（如/opt/SuperMap/License）。

问题17：使用iObjects Java进行空间分析，咨询如何直接读取SHP和FileGDB数据源作为分析输入，并将叠加分析的结果数据集直接创建并保存到新的FileGDB数据源中。

11.3.0 【解决办法】参考示例代码： Workspace workspace = new Workspace(); DatasourceConnectionInfo info = new DatasourceConnectionInfo(); info.setServer("C:\Users\Administrator\Desktop\test1.gdb"); info.setEngineType(EngineType.VECTORFILE); Datasource datasource = workspace.getDatasources().create(info); DatasetVectorInfo datasetVectorInfo = new DatasetVectorInfo(); datasetVectorInfo.setName("aaaa"); datasetVectorInfo.setType(DatasetType.REGION); DatasetVector datasetVector = datasource.getDatasets().create(datasetVectorInfo); datasetVector.setPrjCoordSys(new PrjCoordSys(4326)); DatasourceConnectionInfo info1 = new DatasourceConnectionInfo(); info1.setServer("F:\数据\数据\gdb\gdbs\全国数据.gdb"); info1.setEngineType(EngineType.VECTORFILE); info1.setAlias("sdadsads"); Datasource datasource1 = workspace.getDatasources().open(info1);

    OverlayAnalystParameter parameter = new OverlayAnalystParameter();
    parameter.setTolerance(0.0000000001);
    boolean flag = OverlayAnalyst.intersect((DatasetVector) datasource1.getDatasets().get("分省"), (DatasetVector) datasource1.getDatasets().get("NewRegion"),datasetVector,parameter);
    System.out.println(flag);

问题18：在使用iObjects Java 12.0.1版本时，调用LayerUtilities.getLayerBounds方法，程序抛出ClassNotFoundException，无法找到com.supermap.mapping.LayerMaritimeS100VectorGroup类。

12.0.0 【问题原因】用户工程中缺少了包含com.supermap.mapping.LayerMaritimeS100VectorGroup类的JAR包。 【解决办法】将iObjects Java产品安装目录下bin\com.supermap.mapping.jar包引入到项目依赖中即可。

五、SuperMap iPortal

问题1：咨询iPortal是否可以一次性获取到服务的自定义元数据。期望在请求服务清单列表时，就能返回自定义的元数据，以避免多次请求导致的性能问题。

11.3.0 【问题原因】iPortal现有接口设计中，服务列表接口不包含自定义元数据，需要进入服务详情页单独获取，多次请求导致前端加载慢。 【解决办法】建议用户通过创建一个定时任务，周期性遍历所有服务及其自定义元数据，将结果预先组织成一个包含完整图层树信息的JSON文件。前端加载时直接请求这个静态JSON文件，从而实现快速加载。

问题2：iPortal自带的Tomcat被安全漏扫工具扫描出漏洞，需要进行修复。

11.3.0 【问题原因】iPortal产品自带的Tomcat版本存在已知的安全漏洞。 【解决办法】从超图技术支持网站下载对应iPortal版本的Tomcat漏洞修复补丁包，并根据包内的说明文档执行脚本进行升级。

问题3：为iPortal执行完Tomcat漏洞补丁脚本后，iPortal登录页面的自定义样式和图片全部丢失，恢复为默认样式。

11.3.0 【问题原因】补丁脚本在升级过程中，使用新包中的文件覆盖了用户修改过的webapps/iportal/resource目录，导致自定义的前端资源文件被重置。 【解决办法】补丁脚本在执行时会自动备份被替换的文件。将备份目录中的resource文件夹复制回webapps/iportal/路径下，即可恢复自定义样式。

问题4：延续在小程序中嵌入H5页面的话题，用户进一步咨询是否同样可以使用web-view组件的方式将iPortal门户页面嵌入到微信小程序中。

11.3.0 【解决办法】确认该方案可行。iPortal的Web页面可以作为标准的H5页面，通过小程序提供的web-view组件嵌入到小程序中进行访问和使用。

问题5：iPortal中某个账户无法登录，后台日志出现 "com.supermap.iportal.security.tokens.TokenController" 相关报错。

11.3.0 【问题原因】该iPortal账户的密码已被修改，但用户仍使用旧密码尝试登录，导致登录失败并在后台记录token相关的错误日志。 【解决办法】使用修改后的正确密码进行登录，问题解决。

问题6：咨询iPortal内置的Elasticsearch，其默认占用系统50%内存的配置是否为推荐做法，以及在生产环境中应如何自定义内存大小。

11.3.0 【解决办法】最新版本产品已将ES默认内存由系统50%优化为4GB。对于生产环境，推荐自定义配置，遵循“不超过物理内存50%且不超过31GB”的原则，根据具体机器环境和业务负载来设定。

问题7：咨询如何查看iPortal产品内置的Tomcat版本号。

11.3.0 【解决办法】在iPortal安装目录的bin目录下，有一个version.bat（Windows）或version.sh（Linux）脚本。在命令行中执行该脚本，即可查看到详细的Tomcat及iPortal版本信息。

问题8：iPortal转发iServer服务后，使用iPortal内置的客户端预览新增的代理服务时报404错误，导致地图无法显示，而之前添加的代理服务预览正常。

11.3.0 【问题原因】经排查，用户使用的iPortal版本为10.1.3，而iServer版本为11.3.0。由于版本跨度较大，新版iServer的客户端预览依赖的JS、CSS等静态资源路径发生了变化，旧版iPortal的代理转发配置未兼容这些新路径，导致资源加载失败，页面报404错误。 【解决办法】 方案一：降低iServer版本，使其与iPortal版本（10i系列）保持一致。 方案二：升级iPortal版本至较新的10.1.4或10.2.1双周包，以兼容新版iServer。下载地址：https://pan.baidu.com/s/1T1C-9gZDq4FHvDBY9NpKAg?pwd=6655#list/path=%2F

问题9：iPortal代理的所有服务地址都无法访问。

11.3.0 【问题原因】用户更新了服务器的SSL证书，但没有在iPortal管理页面的“代理设置”中同步更新证书信息，导致iPortal代理服务因证书验证失败而无法访问。 【解决办法】登录iPortal管理页面，进入“系统配置”-“代理设置”，将SSL证书更新为最新的证书文件和密码。

问题10：咨询iPortal是否支持HTTPS协议，以及如何进行配置，从而实现HTTP和HTTPS两种协议同时对外提供服务。

11.3.0 【解决办法】 1. 在{iPortal_HOME}/conf/server.xml文件中，确保同时存在用于HTTP（如8190端口）和HTTPS（如8443端口）的两个Connector节点配置。 2. 取消HTTPS Connector节点的注释，并正确配置keystoreFile（证书文件路径）、keystorePass（证书密码）等参数。 3. 重启iPortal服务后，即可通过两个端口分别使用HTTP和HTTPS协议访问。 参考文档：https://help.supermap.com/iPortal/iP/iportal_management/Portal_Security/SystemSecurity.htm

问题11：安全扫描报告显示产品内置的MariaDB存在安全漏洞，咨询是否可以直接升级MariaDB数据库版本以修复漏洞，以及高版本是否兼容。

11.3.0 【问题原因】产品内置的MariaDB驱动或组件版本较低，存在已知的安全漏洞。 【解决办法】技术支持提供了更新后的文件（已修复漏洞的MariaDB驱动包），用户替换后即可解决该漏洞问题。

问题12：在尝试为iPortal配置HTTPS后，服务无法正常启动。即便将配置文件（server.xml）还原为修改前的版本，启动过程依然卡在许可验证阶段，无法进入正常服务状态。

11.3.0 【问题原因】经远程排查，iPortal启动失败并非由HTTPS配置直接导致，而是在此过程中，许可相关的节点信息出现异常，导致服务在读取许可时卡住。 【解决办法】通过删除iPortal的日志文件，并强制服务重新读取许可配置，解决了启动阻塞问题，服务恢复正常。

问题13：使用iPortal 11.3.0版本（BUILD-251028-8033）进行安全扫描，发现存在多个CVE安全漏洞，咨询修复进展并请求提供已修复漏洞的新版本安装包。

11.3.0 【问题原因】用户使用的iPortal版本中，部分依赖的第三方组件存在已知的安全漏洞。 【解决办法】研发团队已在新版本中对这些漏洞进行了修复。技术支持提供了最新的双周开发板（bi-weekly build）下载链接，用户升级到该版本即可解决漏洞问题。下载地址：https://pan.baidu.com/s/1T1C-9gZDq4FHvDBY9NpKAg?pwd=6655#list/path=%2F

六、SuperMap 其他

问题1：从超图资源中心下载许可中心安装包时，速度极慢且经常中断，咨询是否有更快的下载镜像。

11.3.0 【解决办法】直接将许可放到C:\Program Files\Common Files\SuperMap\License目录下即可

问题2：咨询SuperMap ImageGenerator产品，其AIGC生图能力是产品自带的，还是需要额外接入第三方大模型才能实现。

11.3.0 【解决办法】需要接入第三方的具有生图能力的AI大模型

问题3：使用海图产品iMaritimeEditor 2025创建二次开发工程后，用IDEA打开并运行时报错“无法解析符号 'aranalyst'”。

12.0.0 【问题原因】iMaritimeEditor产品本身不包含ARAnalyst.jar，但其创建的示例代码是从iDesktopX移植过来的，其中包含了对该jar包的引用。 【解决办法】在示例代码中，直接删除或注释掉引用了'aranalyst'相关类的代码即可。

问题4：在许可中心生成许可运行报告（.report）文件时报错。

11.3.0 【解决办法】需要网络才激活网卡，才会有MAC地址，才能生成 report 文件 联网或者iDesktopX目录\bin下，使用jar包生成运行报告， java -jar com.supermap.licensemanager.jar -report test.report。

问题5：一个项目已有一个永久Web许可，后需补充一个限时模块许可，咨询新购的限时许可是否能与原有的永久许可合并导入到同一个Web许可中心。

11.3.0 【解决办法】一个web许可中心只能读取一个web许可文件，一个web许可文件中，要么都是正式许可，要么都是试用许可（1个月或3个月），不能混搭

问题6：官网下载中心提供的某个产品百度网盘链接失效，无法下载。

11.3.0 【问题原因】下载链接失效。 【解决办法】支持人员已收到反馈并立即恢复了网盘链接的有效性。

问题7：咨询是否可以在同一台服务器上配置两个许可，一个为正式许可，一个为试用许可，例如通过部署两个不同端口的Web版许可中心。

11.3.0 【解决办法】不可以。在同一台服务器上，许可程序会优先读取正式许可。同时，Web版许可中心的端口绑定为9183，不允许修改，因此无法在同一服务器上部署两个Web许可中心实例。

问题8：在坐标系定义XML中，当同时存在投影高（ProjectionHeight）和椭球长半轴（SemiMajorAxis）参数时，不确定是否需要手动将投影高加到长半轴上。

11.3.0 【解决办法】在定义坐标系时，用户无需手动计算投影高和长半轴的和。产品内部会根据坐标系定义自动处理这些参数，只需按标准格式分别提供即可。

问题9：咨询最新版本的许可中心生成的硬件信息报告文件，是否可以用于申请并激活旧版本产品（如SuperMap GIS 11i系列）的许可。

11.3.0 【解决办法】可以。新版本许可中心生成的硬件报告是向下兼容的，可以用于申请和激活旧版本产品的许可。

七、SuperMap iManager

问题1：安装iManager for K8S时，部署中心进程一直卡在0%，查看pod日志显示拉取k8s.gcr.io/pause:3.2镜像报错。

11.3.0 【解决办法】Docker工作目录安装错误，需要重新安装

问题2：K8S集群添加了SSL证书后，无法从本地镜像仓库拉取镜像，导致iManager和云套件都无法访问。

11.3.0 【解决办法】镜像仓库服务未启动，需要镜像仓库服务正常，才能正常拉取镜像

问题3：在ARM架构的欧拉（EulerOS）系统上，无法安装官网提供的NFS离线安装包，咨询解决方法。

11.3.0 【解决办法】自己找个相同环境可联网的机器，在线安装后把下载的包拷贝到环境里去安装即可

问题4：部署iManager for K8S时，进度卡在部署中心（deploy-center）的拉起阶段，查看pod状态发现有镜像拉取失败的错误。

11.3.0

【问题原因】K8S的某个节点（node3）无法拉取到部署中心所需的镜像，可能是因为未信任本地镜像仓库地址。 【解决办法】1. 修改该节点上Docker的配置文件daemon.json，在"insecure-registries"中添加本地镜像仓库地址。2. 重启Docker服务。3. 在K8S管理页面删除部署中心的pod，让其自动重建。

问题5：在iManager for k8s的云套件中，咨询如何对一个已经发布的服务额外添加WMS、WMTS等OGC服务接口。

11.3.0 【解决办法】云套件不支持对已发布的服务动态添加接口。需要重新走发布流程，在发布时勾选需要添加的WMS、WMTS等接口类型。

问题6：已成功部署的iManager for K8S，因NFS服务器故障无法恢复，导致iManager无法访问。咨询如何操作能让iManager重新指向新的NFS存储地址。

11.3.0 【解决办法】现场把NFS服务器持久化数据给格式化了，这个等于数据都没有，所以就没办法进行恢复了，只能重新部署iManager和云套件

问题7：客户的云GIS环境被扫描工具检测出安全漏洞，漏洞报告指向一个为gisapp应用开放的临时端口，需要进行紧急修复。

11.3.0 【问题原因】为gisapp应用开放的临时端口存在安全风险，被漏洞扫描工具检测到。 【解决办法】将gisapp的服务类型由NodePort或LoadBalancer改回为ClusterIP，不对外直接暴露端口，从而规避此漏洞。

八、SuperMap iClient3D for WebGL

问题1：咨询iClient3D for WebGL的地形开挖功能，在API文档中未找到设置开挖后底部和侧面纹理材质的接口说明。

11.3.0 【解决办法】通过设置viewer.scene.globe对象下的excavationBottomMaterial和excavationSideMaterial两个参数，可以分别指定开挖后的底部和侧面纹理材质。

问题2：咨询iClient3D for WebGL，对倾斜摄影模型进行开挖后，是否可以设置开挖区域底部的地表纹理。

11.3.0 【问题原因】倾斜摄影不存在侧面与底部纹理的概念 【解决办法】建议同时添加倾斜摄影和与之匹配的地形数据，同时开挖倾斜摄影与地形，设置地形开挖的侧面及底部纹理

问题3：咨询在纯国产化硬件平台上进行三维地球渲染时，需要什么样的配置（特别是显卡）才能达到50帧的流畅度。

12.0.0 【解决办法】建议使用最新的12i Beta版本产品，因其对国产化平台有专门的性能优化。同时，需要在前端代码的Viewer初始化时，增加Performance参数来启用性能优先模式。

问题4：在iClient3D for WebGL 12.0.0 beta版本中，按照建议设置performancePreferenceMode参数时，浏览器控制台报错，提示PerformancePreferenceMode对象不存在。

12.0.0 【问题原因】参数的写法不正确 【解决办法】正确的参数设置方式应为：PerformancePreferenceMode : Performance

问题5：在WebGL三维场景中，通过scene.vectorTileMapOrderInImagerLayers属性调整MVT矢量瓦片与影像图层的显示顺序，导致矢量图层除标注外的几何要素不显示。

11.3.0 【问题原因】1. scene.vectorTileMapOrderInImagerLayers属性设置的时机不正确，必须在矢量瓦片图层添加到场景之后设置才生效。2. 该属性值若设置为0，会将矢量瓦片置于默认的影像底图（球体）之下，导致被遮挡。 【解决办法】确保在MVT图层加载完成后再设置 scene.vectorTileMapOrderInImagerLayers 属性，并将其值设置为1或更大，以保证图层在影像底图之上显示。

九、SuperMap iClient for JavaScript

问题1：iServer的测距接口为解决URL过长问题支持POST请求。咨询iClient for Leaflet中的MeasureService服务是否提供参数以直接发起POST请求。

11.3.0 【问题原因】iClient for Leaflet中的MeasureService封装的服务没有提供直接切换请求方式为POST的参数。 【解决办法】如需使用POST方式请求，可以在前端代码中自行封装和定义接口请求类型及参数，不使用MeasureService的默认方法。

问题2：用户咨询在微信小程序环境下实现地图浏览和地下管线数据上图功能的可行性，并寻求相应的技术实现方案。

11.3.0 【解决办法】建议采用H5技术开发地图功能页面，然后利用微信小程序提供的web-view组件将该H5页面嵌入到小程序中，从而实现地图及管网的展示。

问题3：在iClient for Leaflet中加载REST地图服务时，希望能只加载并显示服务中的指定某几个图层，而不是默认加载地图中的所有图层。

11.3.0 【解决办法】可以通过设置L.supermap.tiledMapLayer图层对象的layersID参数，传入需要显示的子图层ID数组，从而实现按需加载指定图层。

十、SuperMap iMobile Android

问题1：咨询如何实现组合字段查询。用户输入一个由两个不同字段值拼接而成的字符串（如“FT1000”），希望系统能自动拆分并匹配A字段='FT'和B字段=1000的记录。

11.3.0 【问题原因】GIS平台的属性查询遵循标准SQL语法，无法自动解析由多字段值拼接而成的单一查询字符串。 【解决办法】需要在应用层进行处理。在构建查询条件前，通过代码逻辑将用户输入的拼接字符串（如“FT1000”）拆分为两部分（“FT”和“1000”），然后构造一个标准的复合查询条件（例如 A='FT' AND B=1000）再执行查询。

问题2：用户在使用SuperMap 12版本移动端产品时，未能找到对应的32位（armeabi-v7a）开发包，咨询该版本是否不再提供32位支持。

12.0.0 【解决办法】SuperMap V12版本仍然提供32位（armeabi-v7a）的移动端产品包。用户可前往超图官方技术资源中心网站下载。下载链接：https://support.supermap.com/DownloadCenter/ProductPlatform.aspx

十一、SuperMap iObjects .NET

问题1：使用iObjects .NET组件进行开发时，程序运行报错“未能加载文件或程序集“SuperMap.Data.dll”或它的某一个依赖项。找不到指定的模块”，导致程序无法正常运行。

11.3.0 【问题原因】程序运行报错，提示未能加载SuperMap.Data.dll或其依赖项。 【解决办法】检查并统一项目所有引用的SuperMap相关DLL文件版本后，重新运行程序即可。

十二、SuperMap Yukon

问题1：云套件环境发生故障，重启服务器后问题依旧，iserver-gateway、dashboard-api等关键业务无法正常启动，影响系统正常使用。

11.3.0 【问题原因】节点磁盘可用空间低于15%，触发Docker自动清理机制，导致日志组件Fluentd的镜像被意外移除。Fluentd Pod因镜像缺失无法重建，阻塞了iserver-gateway、dashboard-api等关键服务的调度与启动。 【解决办法】手动将缺失的Fluentd镜像导入节点并重建相关组件，然后重启受影响的业务服务，使集群恢复正常。

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

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