一、SuperMap iServer

问题1：在CentOS 7系统的服务器上部署iServer 11.3版本，启动时日志中出现“java.lang.String com.supermap.data.EnvironmentNative.jni_GetBasePath()”错误。

11.3.0
【问题原因】该错误通常与Linux系统的底层库依赖有关，可能是由于缺少libatomic库导致。 【解决办法】尝试在服务器上安装libatomic库，执行命令 yum install libatomic 后重启iServer服务。

问题2：用户反馈一个基于MongoDB发布的地图瓦片服务无法打开，访问时出现异常。经初步判断，是服务提供者连接出现问题，导致地图瓦片无法正常读取。

10.2.1
【问题原因】初步判断是服务提供者（MongoDB数据库）连接失败导致。支持人员建议尝试重新发布服务以验证数据库连接的有效性。 【解决办法】经现场人员重发服务后可以正常读取。

问题3：在iServer GPA中注册并执行操作系统命令（如文件复制）时，任务总是执行失败。希望了解在GPA中正确执行操作系统命令（Windows和Linux）的方法。

11.3.0

【问题原因】GPA中执行外部命令需要通过对应操作系统的命令解释器来调用。 【解决办法】在Windows系统中，命令前需加上cmd /c；在Linux系统中，命令前需加上sh /。例如：cmd /c copy D:\1.las Z:\。

问题4：咨询iServer地图服务缓存更新机制。当地图数据更新后，若不手动清理缓存，已发布的地图服务是否会自动更新展示最新的地图效果，以及开启缓存对性能的影响。

11.3.0
【问题原因】iServer默认会优先读取已有的地图缓存，不会自动感知数据更新并刷新缓存。 【解决办法】若数据频繁更新，可不使用缓存或通过服务管理页面手动清理缓存。也可以在服务配置中设置缓存过期时间，让缓存在指定时间后自动失效并重新生成。

问题5：iServer将服务配置信息和安全数据存储到高斯数据库（GaussDB）时，日志显示其使用的是PostgreSQL驱动而非高斯驱动，导致在政务外网环境下不兼容。

12.1.0
【解决办法】该项目中请以Postgresql驱动链接项目数据库

问题6：项目需要iServer 12.1.0 带有Minio性能优化的NUTV版本，但目前只有Linux x64和ARM版本，需要提供对应的Windows版本。

12.1.0
【解决办法】
项目上使用的 NUTV43 只出了 linux x64 和 linux arm ，没有window版本。

与研发联系获取了，其他NUTV单子出过 windows版本（比项目使用的版本更新一些）
链接: https://pan.baidu.com/s/1xhDxbXM-Ncl3P1KgAJ7Mwg?pwd=cdad

问题7：咨询如何调用iServer的地理处理服务（GPA）时直接返回分析结果，而不是异步返回一个任务ID。

11.3.0
【问题原因】iServer的GPA服务设计为异步执行模式，对于耗时操作会先返回任务ID。 【解决办法】调用GPA服务后，先获取返回的任务ID，再根据此ID轮询或请求任务状态，直至任务完成并获取最终结果。

问题8：用户为 iServer 插入硬件锁后，系统许可信息仍显示为临时许可，有效期并未更新为硬件锁的许可，服务无法正常使用。

12.0.0
【问题原因】用户误将 iDesktopX 产品的硬件锁插入到了 iServer 服务器上。不同产品的硬件锁不通用，因此iServer无法识别该许可。 【解决办法】更换为 iServer 产品对应的正确硬件锁即可。

问题9：咨询在使用 iServer 的 GPA（地理处理自动化）工具执行正射影像自动化流程发布服务时，是否可以在发布过程中直接为服务设置标签。

11.3.0
【问题原因】产品功能限制，iServer的GPA自动化发布功能当前不支持在流程中直接为发布的服务设置标签。 【解决办法】服务发布后，需要到iServer服务管理页面手动为服务添加或修改标签。

问题10：咨询如何将在超图桌面软件中制作的地图成果，转换为奥维地图（OruxMaps）等第三方地图软件能够使用的格式，以实现在奥维上进行信息标注。

11.3.0
【解决办法】将制作好的地图通过iServer发布为标准的WMTS（Web地图瓦片服务）。奥维地图等第三方软件支持加载标准的WMTS服务，通过服务地址即可接入地图。

问题11：iServer通过设置环境变量BSLICENSE_SERVER来配置Web许可中心地址时，未能自动读取并连接。用户尝试了多种格式，但启动时仍需手动配置。

11.3.0
【问题原因】环境变量值的格式不正确，缺少协议前缀。 【解决办法】设置环境变量BSLICENSE_SERVER的值时，需要包含协议前缀，格式应为 ws://IP:PORT 或 wss://IP:PORT。

问题12：咨询SuperMap iServer产品是否提供已集成国产化中间件（如东方通）的安装包，以满足信创环境部署要求。

12.0.0
【解决办法】SuperMap iServer不直接提供与特定国产化中间件绑定的安装包。用户需自行下载通用的.war包格式的iServer，然后根据官方文档指引，将其手动部署到东方通等国产化中间件中。

问题13：iServer 11.0.1 版本被扫描出存在安全漏洞，咨询如何修复该漏洞。用户在收到新版本后，进一步咨询升级后如何配置。

11.3.0
【问题原因】产品旧版本存在安全漏洞，已在新版本中修复。 【解决办法】1. 下载官方提供的已修复漏洞的新版本iServer进行升级。2. 升级操作：先备份原iServer中的配置文件，然后在新的iServer环境中恢复配置。参考文档：https://support.supermap.com/DataWarehouse/WebDocHelp/iServer/Server_Service_Management/backupAndRestore.htm

问题14：使用iDesktop生成的矢量瓦片，通过iServer发布后，在ArcGIS JS API 3.x前端进行加载，地图无法缩放到15级以上，放大后不再请求新的瓦片。

11.3.0
【解决办法】编辑矢量瓦片缓存目录下的styles/style.json文件，在sources节点下手动添加"minzoom":0和"maxzoom":21（或其他最大层级）属性，以定义服务的显示级别范围。修改后重启iServer服务或重新发布服务即可。

问题15：将标准的3D Tiles数据通过iServer 11版本发布为三维服务后，使用iServer内置的预览功能（for Cesium或for WebGL）加载服务时失败，浏览器控制台报错，提示gltf中包含不支持的KHR扩展。

11.3.0
【问题原因】3D Tiles数据中的gltf模型使用了KHR扩展，而iServer 11版本内置的iClient3D for WebGL库版本较低，不支持解析此扩展。 【解决办法】服务本身发布是成功的。需要使用支持KHR扩展的新版客户端进行加载，例如使用SuperMap 12.0及以上版本的iClient3D for WebGL产品包来构建前端应用加载该服务。

问题16：忘记了iServer服务管理页面的登录密码，咨询如何进行重置。

11.3.0
【解决办法】1. 停止iServer服务。 2. 进入iServer安装目录的\bin\文件夹下。 3. 双击运行passwordreset.bat（Windows）或passwordreset.sh（Linux）脚本。 4. 脚本执行成功后，重启iServer服务，密码将重置为初始默认值（admin/supermap）。

问题17：iServer发布的某个地图服务，可以正常显示地图，但无法通过GetFeatureInfo等方式进行查询。该问题已持续一周，客户催促紧急解决。

11.3.0
【问题原因】用户在处理业务数据入库到PolarDB时，自行将超图系统保留字段SmID的字段类型从integer(int4)修改为了bigint(int8)，导致iServer内核在执行查询时因字段类型不匹配而失败。 【解决办法】将相关数据表中SmID字段的类型改回integer(int4)，之后服务查询功能恢复正常。

问题18：用户发现iServer发布的WMTS服务地址默认为XYZ风格的RESTful URL，而项目需要对接支持标准KVP（键值对）请求格式的第三方客户端，咨询如何切换WMTS的请求地址格式。

11.3.0
【解决办法】在iServer服务管理界面中，将WMTS服务的请求格式从默认的RESTful（XYZ风格）修改为KVP（键值对）模式，即可生成符合标准OGC规范的WMTS请求地址。

问题19：在Windows虚拟机上，若不使用管理员身份启动iServer，服务无法正常启动。咨询是否必须使用管理员权限，以及不使用会有何影响。

11.3.0
【问题原因】Windows系统的权限控制可能导致非管理员用户启动iServer时，因无法读写某些系统资源或端口而失败或运行异常。 【解决办法】建议始终使用管理员身份运行iServer的启动脚本，以确保服务拥有完整权限，避免潜在的功能报错。

问题20：咨询超图iServer的服务请求是否支持通过在请求头中携带Cookie进行权限验证。

11.3.0
【解决办法】明确告知用户，SuperMap iServer自身的安全认证机制是基于Token的，不支持通过Cookie进行权限验证。建议用户采用Token方案进行服务的安全访问控制。

问题21：使用iServer地图服务查询接口时，需要对查询结果按指定字段进行分组统计，但不清楚如何设置查询参数才能生效。

11.3.0
【问题原因】用户在构建查询参数时，将分组统计参数groupBy放置在了错误的位置，导致参数不生效。 【解决办法】进行分组统计时，groupBy="字段名"参数需要设置在queryParams参数对象内部，而不是与其并列。可参考产品开发文档中关于queryParams的说明进行正确配置。

问题22：咨询如何在SuperMap iDesktop或iServer中对接部委“一张图”系统提供的WMTS服务。用户尝试直接使用服务地址连接失败，经过排查确认服务为栅格瓦片，并最终明确了在iServer中通过能力文档进行代理发布的正确方法。

11.3.0
【问题原因】在注册WMTS服务时，使用了单张瓦片的URL，而不是服务的能力文档（GetCapabilities）URL，导致产品无法将其识别为标准WMTS服务。 【解决办法】在SuperMap iServer中，通过发布新的GIS服务来代理转发该WMTS服务。需要先获取该服务的WMTS能力文档URL，然后在iServer服务管理页面选择“发布WMTS服务”，并填入该能力文档地址即可。

问题23：用户使用倾斜摄影数据生成了带LOD（层次细节模型）的S3M缓存，并通过iServer发布为三维服务。但在WebGL客户端进行浏览时，发现模型的LOD效果未生效，缩放地图时模型精细度没有变化。

11.3.0
【问题原因】用户可能对S3M缓存的LOD机制存在误解。S3M格式的LOD是内建在切片文件结构中的，iServer发布时无需额外配置，由客户端（如iClient3D for WebGL）根据视点远近自动请求不同层级的瓦片。 【解决办法】1. 确认缓存生成时已正确构建LOD。2. 在浏览器端按F12打开开发者工具，切换到“网络(Network)”面板，在缩放场景时观察是否有动态请求不同路径或层级的.s3mb文件，以判断LOD是否在正常调度。

问题24：iServer服务因未知原因停止后无法启动，启动时出现“启动子对象时错误”的异常，导致服务不可用，急需技术支持恢复。

11.3.0
【问题原因】iServer软件包损坏，具体原因尚不明确。 【解决办法】重新解压一个新的iServer包，并将原iServer的配置文件复制到新解压的目录中，即可恢复服务正常。建议后续开启iServer定时备份功能，以便在类似情况发生时快速恢复。

问题25：访问iServer服务管理器首页时出现错误提示，且服务列表为空，无法正常管理已发布的服务。

11.3.0
【问题原因】iServer在凌晨定时回收资源时，因网络波动等原因导致其内置的SQLite数据库文件在读取时发生磁盘I/O错误，造成文件损坏，服务无法正常加载。 【解决办法】对iServer进行重建操作，系统重新生成配置文件和数据库后，服务恢复正常。

问题26：iServer 升级到 12.0.0 版本并迁移服务后，之前配置的约二三十个服务标签全部消失。新添加的标签可以正常显示和使用，但无法恢复旧标签。

12.0.0
【问题原因】服务标签丢失的具体原因未明确，可能与服务升级迁移过程有关。 【解决办法】1. 重新手动添加所有丢失的服务标签。 2. 完成添加后，对iServer实例配置进行备份，备份文件为 [iServer安装目录]\webapps\iserver\WEB-INF\iserver-instanceRecord.db，以防止配置再次丢失。

问题27：在Linux环境下使用许可工具更新试用许可时，系统无法检测到新的许可文件，导致许可更新失败。

11.3.0
【问题原因】许可工具所在的目录下存在多个许可文件，导致程序在读取时加载了旧的或无效的许可。 【解决办法】检查许可文件存放目录，将所有过期的或不需要的旧许可文件删除或移走，确保目录下仅保留一个最新且有效的许可文件，然后重新运行许可工具即可成功更新。

问题28：iServer GPA中创建的模型（导入RVT和DGN数据并发布服务），在英文版iServer执行时报错但日志为空；在中文版执行成功但日志有“目标数据集为空”的错误，且发布的DGN服务在预览时无内容。

12.0.0
【问题原因】iServer内置的预览客户端（WebGL）版本较低，不支持正确渲染DGN模型数据。服务本身发布是正常的。 【解决办法】1. 在前端应用中使用新版本的iClient3D for WebGL加载该服务。2. 替换iServer产品包中的WebGL，目录地址:supermap-iserver-2025u1a-windows-x64-deploy\webapps\iserver\WEB-INF\lib\ise-representations-3d-12.0.1-20250929.171749-3739.jar\META-INF\resources\representations 下的旧的WebGL库文件为新版本。

问题29：在国产化Linux系统部署iServer后，遇到多个问题：无法在“文件管理设置”中配置默认目录、已发布的服务无法暂停或删除、iServer进程无法正常停止。

11.3.0
【问题原因】1. iServer内置的Tomcat配置文件中未配置允许HTTP的PUT、DELETE请求方法，导致服务管理页面的暂停、删除操作失败。2. 在“全局设置”中配置默认文件目录时，因系统用户权限不足或XML配置文件修改位置不正确，导致配置无法保存生效。3. 使用非root用户无法停止由root用户启动的iServer进程。 【解决办法】1. 修改iServer内置Tomcat的配置文件，添加对PUT、DELETE请求方法的支持。2. 切换到root用户，确保对iServer安装目录及配置文件有读写权限，再通过iServer管理页面或直接修改iserver-system.xml文件来正确设置文件管理目录。3. 使用root权限执行kill -9 PID命令强制停止相关进程。

问题30：咨询新版本iServer提供的矢量瓦片自动更新功能应如何配置和使用，以便在后端数据库数据更新后，前端访问的矢量瓦片服务能自动刷新。

11.3.0
【解决办法】1. 在iDesktopX中为PostGIS数据源的数据集注册版本管理。2. 编辑iServer安装目录/bin/setenv.bat脚本，新增set clearOldCacheInterval=3配置，以设置变化检测间隔（例如3秒）。3. 正常生成矢量瓦片。4. 在iServer中发布该矢量瓦片服务并确保开启缓存。5. 将生成的瓦片复制到iServer的缓存目录中。完成以上配置后，在桌面端修改数据，前端刷新地图即可看到更新。

问题31：iServer 使用 Docker 部署并进行版本更新后，之前在宿主机 /home 目录下创建的文件夹无法被访问到，导致在管理页面中部分目录选择不到。

11.3.0
【问题原因】iServer采用Docker容器化部署，默认只挂载了指定的数据路径，并未挂载用户之前自定义的宿主机路径。 【解决办法】1. 重新配置Docker容器，将原宿主机路径挂载到容器中。 2. 将模型等数据迁移到当前已挂载的数据路径下。

问题32：在Linux服务器上部署的iServer集群中，部分子节点启动时无法读取到许可，导致服务扩展模块不可用，且配置许可后页面反复跳转到初始化。

11.3.0
【问题原因】iServer集群中许可主节点配置错误，子节点未指向持有高级版许可的服务器。 【解决办法】确认持有高级版许可的服务器（53服务器）作为许可主节点。在其他所有子节点的许可配置界面中，将主节点地址明确指向该服务器的IP地址，即可完成许可同步和集群的正常启动。

问题33：SuperMap iServer服务突然无法启动，查看日志（iserver.log）发现有关于创建geometry的死循环报错。

11.3.0
【问题原因】推测是iServer的服务配置文件（iserver-services.xml）损坏或存在异常配置，导致服务在加载时陷入死循环。 【解决办法】解压一个新的同版本iServer，然后将原iServer实例中的服务配置文件（位于\webapps\iserver\WEB-INF\目录下）拷贝至新实例中替换同名文件，再启动新实例即可恢复服务。

问题34：用户需要用于监控iServer服务健康状态并在服务异常时自动重启的脚本。该脚本主要用于自动化运维，确保iServer服务的持续可用性，减少因服务中断导致的人工干预。

11.3.0
【解决办法】提供两个Shell脚本，一个用于健康状态监测，另一个用于执行重启iServer服务的操作。用户可结合Linux的crontab等定时任务工具，定期执行监测脚本，当监测到服务异常时调用重启脚本，实现自动化运维。

问题35：iServer启动时，日志报告Database may be already in use: "Locked by another process"错误，导致启动失败，咨询该错误的处理方法。

11.3.0
【问题原因】iServer进程没有完全关闭，导致日志数据库文件被锁定。 【解决办法】强制终止残留的iServer进程。在Linux系统下，使用ps -ef | grep iserver命令查看残留进程，然后使用kill -9 命令结束进程后重启iServer。

问题36：咨询iServer中服务提供者绑定单个与绑定多个的区别。希望了解绑定多个工作空间等服务提供者后，发布的服务内容会产生何种变化，以及其对服务访问的影响。

11.3.0
【解决办法】iServer绑定多个服务提供者（如多个工作空间）后，发布的服务（如地图服务）会包含所有提供者中的全部内容。例如，绑定两个工作空间，则发布的地图服务会包含这两个工作空间中的所有地图。

问题37：咨询三维缓存是否支持SQL查询，以及模型数据集的推荐查询方式。目前官网示例多使用数据服务进行查询，希望确认是否可以通过SQL直接查询三维缓存或模型数据集。

11.3.0
【解决办法】三维缓存目前不支持直接进行SQL查询。对于模型数据集，正确的查询方式是将其发布为数据服务，然后通过数据服务进行SQL查询，并利用SMID与三维模型进行关联。

问题38：iServer启动成功后无法访问，通过netstat查看端口发现监听在IPv6协议上，而实际需要使用IPv4进行访问。

11.3.0
【问题原因】iServer服务器本身已支持IPv4地址的8090端口访问，但服务器防火墙或安全策略未对其他机器开放该IPv4端口的访问权限。 【解决办法】在服务器上添加入站规则，对需要访问的客户端IP开放IPv4地址的8090端口。

问题39：咨询iServer发布的MVT服务和WMTS服务是否为OGC标准，以及是否能被高德地图等第三方地图服务调用加载。

11.3.0
【解决办法】SuperMap iServer发布的WMTS服务符合OGC标准，可以被标准客户端调用；而MVT服务遵循的是Mapbox标准。

问题40：iServer服务出现内存占满、服务无响应的问题。该问题在不同服务器上重复出现，影响服务的稳定性。

11.3.0
【问题原因】iServer 11.3.0 版本的定时回收功能存在偶发性问题，可能导致进程清理不彻底，从而引发重启失败和内存持续占用的情况。 【解决办法】建议停用iServer内置的定时回收功能，改用外部定时重启脚本来管理服务。脚本应在重启iServer前，先检查并强制清除残留的iServer进程，以确保服务能被彻底重启。

问题41：咨询如何在iServer中发布WMS（Web Map Service）和WMTS（Web Map Tile Service）服务。

11.3.0
【解决办法】发布WMS/WMTS服务有两种方式： 1. 若要转发其他平台的OGC服务，在发布向导中选择“转发服务”并输入源服务地址。 2. 若要将本地地图发布为服务，应选择“发布工作空间”，然后在服务列表（如REST-地图服务）的扩展服务中，勾选发布WMS和WMTS服务即可。

问题42：咨询iServer的GP（Geoprocessing）工具或REST API是否支持根据一个任意多边形范围内的离散点及其高程值来生成等值线。

11.3.0
【解决办法】可以使用iServer的空间分析服务中的提取等值线功能实现。通过调用REST API，传入点数据、高程字段以及作为分析范围的多边形几何对象即可生成等值线。API文档参考：iServer REST API - 提取等值线

问题43：调用iServer提取等值线接口时，服务返回错误“设置的提取范围错误”，咨询提取范围参数（点集合）的正确格式要求。

11.3.0
【问题原因】iServer提取等值线接口的提取范围参数（clipRegion）需要传入一个完整的面（Polygon）几何对象，而不是点集合。 【解决办法】按照API要求，构造一个包含type、parts和points属性的面几何对象的JSON字符串作为提取范围参数，例如：[{“type”:“REGION3D” , “parts”:[4], “points”:[{“x”:121.21,“y”:41.21,“z”:5}, …}]}]。

问题44：部署在云环境的GIS服务访问响应缓慢，部分节点出现异常。经排查，怀疑与服务缓存配置及服务器资源有关，影响了动态出图效率。

11.3.0
【问题原因】1. 内部定时扫描组件的缓存扫描间隔（10s）过短，高频扫描可能导致缓存文件锁定，影响服务访问。2. 服务器节点内存占用过高（达95%），导致GIS引擎出图效率下降。 【解决办法】1. 将定时扫描组件层缓存的间隔由10秒修改为300秒。2. 重启服务器释放资源。3. 统一各服务节点的镜像版本。4. 分离未切缓存的地图服务以降低动态出图压力。

问题45：用户先前反馈iServer连接数据库时出现连接数过多的问题。经过排查，发现系统中连接该数据库的客户端过多。技术支持协助从iServer端进行了相关优化，同时项目侧也进行了调整，减少了数据库连接，解决了连接数不够用的问题。

11.3.0
【问题原因】连接目标数据库的客户端过多，导致数据库连接池耗尽。 【解决办法】项目侧和超图技术支持共同对系统进行优化，特别是调整了iServer端的数据库连接配置，使得数据库连接数恢复到正常可用范围。

问题46：跟进历史问题：服务器重启后，iServer服务启动成功但浏览器无法访问。用户反馈问题已自行恢复正常。

11.3.0
【解决办法】此问题为历史问题的跟进确认。用户反馈服务在重启后已能正常访问，问题自行解决。

问题47：咨询GIS平台未来是否计划支持使用崖山数据库替代MongoDB来存储地图瓦片（切片），以实现项目中不同类型数据存储技术的统一。

11.3.0
【问题原因】数据存储模型不匹配。地图瓦片数据是非结构化的二进制数据，适合使用MongoDB这类文档型数据库进行存储和高效读写；而崖山数据库是传统的关系型数据库，不适合存储海量瓦片文件。 【解决办法】建议继续使用MongoDB进行瓦片存储，这是目前业界主流且性能最优的技术方案。

问题48：咨询iServer并发性能调优方法。在压测中，当并发数从50增加到100时，平均响应时间从100ms上升到300ms以上，寻求性能提升方案。

12.0.0
【解决办法】gisapp推荐三个副本，并分别落到不同的k8s节点上，网关推荐1-2个副本

问题49：用户咨询超图产品使用MongoDB存储地图瓦片时的数据表结构是怎样的，并希望能提供相关说明文档。

11.3.0
【解决办法】超图产品在MongoDB中存储瓦片主要由以下表组成：images_xxx（存储瓦片文件）、metadatas（地图元信息）、styles_xxx（矢量瓦片样式信息）和tiles_xxx（瓦片信息）。

问题50：用户在iServer服务器上使用分布式切片功能时，发现切片任务的实时速度显示为0，任务无法正常进行，影响了大规模地图瓦片的生产效率。

11.3.0
【问题原因】iServer默认参与切图的进程数较少（如4个），在进行大规模切图时可能导致处理能力不足，从而显示速度为0。 【解决办法】通过开启iServer的单机多进程模式，增加用于切图的进程数量，以提升切片效率。具体配置可参考官方文档：https://support.supermap.com/DataWarehouse/WebDocHelp/iServer/Server_Service_Management/GISService_Config/Multi_processes.htm

问题51：咨询iServer 12.0版本具体使用哪种类型的许可证，是否为文件型的试用许可。

12.0.0
【解决办法】用户通过截图展示了其持有的许可证类型，技术支持确认该类型可用，为用户提供了明确的答复。

问题52：使用浏览器访问iServer首页时，页面一直停留在初始化界面，无法正常进入管理员登录页面。

11.3.0
【问题原因】1. iServer版本较旧，初始化页面地址有变动。2. 旧版UI通过云许可进行初始化时存在兼容性问题。 【解决办法】首先使用文件型许可完成iServer的初始化并正常登录。登录成功后，再进入许可管理模块，使用“切换许可”功能，将许可类型切换为云许可即可。

问题53：用户在使用64核的iServer许可时，无法在拥有128核或更高配置的服务器上成功部署和配置许可，系统报错提示许可核数不足。

11.3.0
【问题原因】硬件服务器的CPU核数（128核）超出了iServer许可文件允许的最大核数（64核）。 【解决办法】申请与服务器硬件CPU核数相匹配或更高的iServer许可文件。

问题54：项目需要开发一个GPA（地理处理自动化）算子，用于解析特定的XML文件并将其内容作为属性附加到模型数据上，但自行开发困难，希望超图提供代码Demo。

11.3.0
【问题原因】项目需要自动化处理XML数据，但用户对基于iObjects Java开发自定义GPA算子不熟悉。
【解决办法】超图技术支持人员根据用户提供的XML格式和业务逻辑，开发并交付了一套完整的GPA算子（铁科院.gpaml）及详细使用说明，用户可在此基础上直接使用或进行二次开发。扩展开发教程：https://help.supermap.com/iServer/zh/DevelopGuide/Extend_iServer/Extend_GPtool.htm

问题55：项目已在iServer上发布了大量独立的三维服务，现希望将这些服务通过嵌套SCP的方式进行合并，以优化前端加载性能，咨询如何高效实现。

11.3.0
【解决办法】在iServer服务管理页面的“服务提供者”中，可以找到每个已发布三维服务的缓存文件（.scp）的物理路径。获取这些路径后，即可在桌面端中通过批量添加的方式，创建一个嵌套所有子SCP的主场景缓存文件。

问题56：使用iDesktopX生成的影像瓦片，在桌面端加载显示正常，但通过iServer发布服务后，在浏览器端预览时仅显示一小块，范围不完整。

11.3.0
【问题原因】NFS网络文件系统的缓存机制导致iServer读取到了旧的或不完整的瓦片索引文件（.sci）。 【解决办法】登录到NFS存储服务器，在存放瓦片数据的目录下，将该瓦片的.sci索引文件复制一份再重命名回去（或直接复制一份新命名的sci），然后重新发布服务即可。建议后续更新数据时，使用新的文件路径以规避缓存问题。

问题57：咨询iServer部署在云服务器，当并发用户在100至150人且涉及动态地图服务访问时，所需的网络带宽大小。

11.3.0
【解决办法】根据并发用户数和访问类型估算，建议按照每个用户1m/s的速度来预估，总带宽建议在千兆或以上以保障访问流畅。

问题58：iServer执行地图瓦片切图任务，数据量较大（切图层级0-14级），耗时非常长（数天甚至数周）。用户咨询切图时并发执行其他分析任务是否会影响效率，并寻求提升切图性能的方法，如调整iServer配置、优化数据等。

11.3.0
【问题原因】初步定位为源数据量过大且未经优化，同时数据库读取性能存在瓶颈，导致iServer在进行地图瓦片切图时效率低下。此外，默认的iServer JVM内存配置也可能不足以支撑大规模切图任务。 【解决办法】1. 优化数据：建议在切图前，使用iDesktopX对数据进行优化，包括设置可见比例尺、进行分级配图、对矢量数据进行抽稀或重采样处理，并避免切图层级过于密集。 2. 调整iServer配置：调大iServer的JVM内存，为切图任务提供更多系统资源。 3. 排查瓶颈：检查并优化数据库服务器的读取性能和网络状况。

问题59：咨询iServer服务在对参数化对象进行空间分析时，是否会像桌面端一样出现分析结果不准确的问题。

11.3.0
【问题原因】提问者对桌面端参数化对象问题的理解有偏差，桌面端问题是投影转换时崩溃，而非空间分析结果不准确。 【解决办法】技术支持澄清了桌面端的问题实质，并说明iServer空间分析结果理论上是准确的。

问题60：iServer后台日志中持续出现数据源连接失败的错误，怀疑是由于服务发布后又被删除，但相关配置未被彻底清理导致。由于服务列表中找不到关联的服务，无法快速定位问题源。

11.3.0
【问题原因】iServer中可能存在已删除的服务，但其配置信息未被完全清理，导致后台程序仍尝试连接其关联的、已失效的数据源，从而产生持续的连接错误日志。 【解决办法】由于无法通过错误日志直接定位到具体服务，可以通过编写iObjects Java脚本进行排查。核心逻辑为：遍历所有已发布服务对应的工作空间，打开后逐个检查其中的数据源是否能正常连接（调用isConnected()方法判断），从而定位到包含连接失败数据源的服务。

问题61：在iServer服务管理器中发布工作空间时，系统提示未知错误，导致发布操作失败，无法正常提供地图服务。

11.3.0

【问题原因】iServer长时间运行，未进行资源回收，导致iServer异常。【解决办法】重启iServer并开启资源定时回收功能后正常。

问题62：用户反馈重启服务器后，无法访问iServer首页。技术支持通过日志分析，发现服务器时间不准确，并可能存在未被终止的旧线程。

11.3.0
【问题原因】1.服务器防火墙限制了8090端口的访问；2.iServer服务存在未被完全终止的旧线程，影响了新服务的启动。
【解决办法】1. 确认服务器的8090端口已开放，且没有防火墙策略限制；2. 在重启服务前，先手动终止（kill）所有与iServer相关的进程，然后重新启动服务，并清空浏览器缓存后再次尝试访问。

问题63：在未重启iServer服务的情况下，iServer的GPA（地理处理自动化）服务出现未知状态异常。

11.3.0

【问题原因】iServer定时资源回收功能异常，iServer未正常重启，导致GPA功能未正常启动。【解决办法】更新iServer镜像到：registry.ispeco.com/supermap/iserver:11.3.0-1676-amd64，即可解决。

问题64：iServer启动正常后，部分服务无法启动，点击启动无效。经排查，此问题与版本升级操作不当有关，手动替换配置文件导致服务加载异常，并伴随数据库文件被锁（SQLITE BUSY）等错误。

11.3.0
【解决办法】
1、重新迁移配置文件：一般迁移iserver-services.xml、iserver-system.xml即可，文档里的配置文件不需要都迁移，根据项目使用情况。参考文档：
https://blog.csdn.net/supermapsupport/article/details/126296927
2、报[SQLITE BUSY] The database file is locked，是有残留进程，需要杀干净；
Linux命令： ps -ef | grep iserver 查看iServer进程
如果没杀干净，使用使用kill -9 结束进程，再重启；
3、重启服务器，最终服务状态正常。

问题65：iServer服务管理中，一个三维模型服务链接失效。在工作空间管理页面停止该服务后，“启动”按钮消失，无法重新启动。尝试重新发布服务也未能解决问题。

11.3.0
【问题原因】服务本身连接失败
【解决办法】检查工作空间后，重新发布，在服务管理界面停止、启动服务没有问题

问题66：iServer 10.2.1版本连接恒辉数据库的连接数过多（超1000个），导致数据库负载过高（CPU超90%）。用户询问如何在不重启服务的情况下释放数据库连接，以降低服务器压力。

10.2.1
【问题原因】iServer 10i版本默认不会主动断开与数据库的空闲连接，且现场部署的服务实例较多，导致数据库连接池累积了大量连接。
【解决办法】建议从以下几方面进行优化：

1. 开启iServer服务实例动态化管理，使空闲服务被主动销毁从而断开数据库连接。参考文档： https://help.supermap.com/iServer/Server_Service_Management/properties.htm#%E6%9C%8D%E5%8A%A1%E5%AE%9E%E4%BE%8B%E5%8A%A8%E6%80%81%E5%8C%96%E7%AE%A1%E7%90%86%E8%AE%BE%E7%BD%AE
2. 梳理并合并服务，或降低数据源连接池的最大连接数设置。
3. 升级iServer至11.3.0或更高版本，新版本已优化该机制。

问题67：iServer日志中持续报错，提示无法连接某个数据源。希望定位是哪个已发布的服务在尝试连接这个不存在或无法访问的数据源，因为从服务列表看不出异常。

11.3.0
【解决办法】提供一个基于iObjects Java组件编写的脚本，用于遍历指定文件夹下的所有工作空间文件，查找引用了特定名称数据源的工作空间，从而辅助定位问题服务。找到问题数据源后，修改问题数据源连接参数解决报错问题。

问题68：使用iServer的GPA（地理处理自动化）二元分类算子时，无法直接选择数据库型数据源作为输入参数，咨询处理方法。

11.3.0
【问题原因】产品设计如此，iServer的GPA二元分类算子当前不支持直接以数据库型数据源作为输入。 【解决办法】采用文件型数据源（UDBX）作为中介。先将数据从数据库导出到UDBX，使用GPA算子进行分析处理，然后将结果数据再从UDBX复制回数据库中。

问题69：咨询如何基于iServer实现无人机航线（线要素）与地形（DSM栅格数据）的碰撞检测，以判断航线是否存在低于地形的危险区段，并希望提供相关接口或示例。

11.3.0
【解决办法】当前无直接接口，需通过组合服务实现：1. 确保航线为三维线且带高程。2. 对航线进行插值生成一系列检查点。3. 遍历检查点，调用iServer栅格查询服务获取对应位置的DSM高程。4. 比较检查点自身高程与查询到的DSM高程，判断是否碰撞。

问题70：使用新版iDesktopX生成的S3M缓存，在iServer 11.2.1版本中发布并预览时，模型显示为纯黑色，无法正常渲染。

11.2.1
【问题原因】新版本桌面工具生成的S3M缓存与旧版iServer（11.2.1）内置的预览客户端存在兼容性问题。同时，直接发布的SCP服务未在场景中为图层设置LOD，导致渲染异常。 【解决办法】1. 直接发布服务的SCP地址。2. 在iDesktopX的场景中，为该S3M缓存图层设置合适的LOD参数后，再保存场景并发布。

问题71：咨询iServer三维服务是否提供后端接口，能让第三方仅查询并加载服务中某一个特定的模型对象，而不是加载整个模型图层。

11.3.0
【解决办法】SuperMap iServer的服务端接口，其三维数据加载的最小粒度是图层（Layer）。无法通过后端接口直接控制只加载一个图层中的某一个模型。要实现此需求，需在数据组织层面进行处理，即将需要独立加载的单个模型预先存为单独的图层进行发布。

问题72：咨询iServer产品是否支持集成客户方提供的特定加解密API，来对发布的地图服务传输的数据进行加密和解密。

11.3.0
【解决办法】SuperMap iServer产品不支持集成第三方的自定义加解密API来对地图服务传输的数据流进行加密。产品有自身的安全和权限控制机制（如Token认证），但该框架无法被外部加密库替换。

问题73：在外网iServer服务器上，发布一个包含PostGIS数据源连接的工作空间（.smwu）时失败。

11.3.0
【问题原因】工作空间在本机创建，其中连接的PostGIS数据源使用的是代理IP，导致iServer服务器通过该IP无法访问数据源。 【解决办法】修改工作空间文件（.sxwu）中sml:Server节点的IP和端口信息为服务器可访问的正确地址。

问题74：在本地iServer上发布的地图服务，修改样式后，通过浏览器访问服务时地图风格未更新。

11.3.0
【问题原因】服务端和客户端浏览器存在缓存。 【解决办法】在iServer服务管理中刷新工作空间并“清缓存”，同时清理浏览器缓存。

问题75：Linux环境下，iServer重启后，其Web管理页面无法访问。日志显示启动失败，怀疑存在残留进程或端口冲突。

11.3.0
【问题原因】存在iServer残留进程或端口被占用，导致iServer启动异常。 【解决办法】1. 使用 ps -ef | grep iserver 检查并用 kill -9 彻底杀掉所有iServer相关进程。2. 检查8090及 iserver-geoprocessing.xml 中配置的端口（如8097）是否被占用，如有冲突则修改为可用端口。3. 清理干净进程后重启iServer。

问题76：咨询iServer是否支持跨服务器发布服务，例如iServer部署在A服务器，而数据文件（如工作空间）存放在B服务器。

11.3.0
【解决办法】在iServer发布服务时，选择“上传数据”的方式。此操作会将位于其他服务器的数据文件上传到iServer所在的服务器，并完成发布。

问题77：在数据源中为字段设置了值域（Domain），然后通过iServer将该数据源发布为数据服务，咨询客户端通过服务查询数据时，是否能获取到字段的值域信息。

11.3.0
【解决办法】目前iServer发布数据服务后，REST服务接口的返回结果中不包含字段的值域（Domain）属性信息。客户端无法通过服务直接获取该信息。

问题78：咨询iServer 10和iServer 12版本在发布三维服务时，其操作步骤和支持的数据源格式（如SCP文件）是否保持一致，以及版本间的兼容性问题。

12.0.0
【解决办法】iServer 12版本发布三维服务的步骤与iServer 10版本一致。数据源方面，新版本对旧版本向下兼容，但建议保持客户端工具与服务端软件版本一致以获得最佳体验。

问题79：在Linux服务器上，使用iServer 12.0.1版本发布工作空间（.smwu）时，在选择文件后点击“下一步”无响应并提示“发生错误”，无法继续发布流程。

12.0.0
【问题原因】服务器操作系统的GLIBC库版本（2.17）低于iServer 12.0.1版本要求的最低版本（2.28），导致iServer核心功能无法正常运行。 【解决办法】通过安装Docker，在Docker容器中部署iServer 12.0.1。Docker环境可以提供符合要求的依赖库，从而解决环境兼容性问题，使服务发布功能恢复正常。

问题80：咨询在一台已经运行一个iServer实例的服务器上，如何再启动一个新的iServer实例，以及需要修改哪些端口以避免冲突。

12.0.0
【解决办法】在同一台服务器部署多个iServer实例，需要修改新实例的配置文件以避免端口冲突。具体需要修改的端口可参考官方帮助文档，但需注意部分端口（如许可服务、Spark相关端口）不可修改。建议尽量为每个实例使用独立的服务器。

问题81：在启动iServer 12版本后，访问服务管理器页面，发现左侧菜单及首页的“服务管理”等按钮点击后没有反应，无法进入管理界面。

12.0.0
【问题原因】浏览器缓存了旧版本或其他iServer实例的前端页面文件，导致与当前启动的iServer版本不匹配，出现页面功能异常。 【解决办法】清理浏览器缓存后重新访问iServer服务管理器页面即可恢复正常。

问题82：使用iServer 11.3.0版本发布在桌面端制作的嵌套SCP文件时，上传和发布服务失败，咨询是否为iServer版本问题。

11.3.0
【问题原因】使用的iServer 11.3.0版本较低，对嵌套SCP文件的支持不完善。 【解决办法】升级iServer到最新的11.3.0补丁包或直接使用12.0.1版本即可解决。

问题83：咨询将多个模型数据发布为一个聚合的数据服务的方法，类似使用嵌套SCP将多个三维缓存合并为一个三维服务。

11.3.0
【解决办法】可以将包含多个模型数据集的数据源作为一个整体进行发布。发布成功后，生成的数据服务地址下会包含该数据源中的所有数据集，从而实现一个服务访问多个模型数据。

问题84：在iServer上预览二维地图服务正常，但前端Web应用加载该服务后，在特定的地图比例尺下部分点要素不显示。

11.3.0
【问题原因】地图中设置了标签专题图，并且其压盖策略导致在某些比例尺下，点要素被标签文本所遮挡（压盖），从而看起来像是“丢失”了。 【解决办法】在iDesktop中打开该地图，调整标签专题图的显示策略，或直接移除标签专题图后重新发布服务。

问题85：用户咨询iServer产品中的“硬件加速”设置是否对二维地图的性能有提升作用，希望明确该功能的适用场景。

11.3.0
【解决办法】iServer中的硬件加速设置仅适用于动态图层（如动态标绘层），对普通的静态二维地图图层无效，无法起到加速作用。

问题86：使用curl命令请求iServer发布的三维服务（S3MB瓦片数据）时，命令行返回错误信息，不确定是否为服务端问题。

11.3.0
【问题原因】iServer服务正常返回了S3MB格式的二进制三维瓦片数据。curl工具本身无法解析或显示二进制文件内容，因此在其控制台输出了看似乱码或错误的提示，这并非iServer的服务端错误。 【解决办法】该现象为客户端工具限制导致，属于正常情况。建议使用浏览器开发者工具（Network面板）或专业的API测试工具（如Postman）来验证服务的响应是否正确，这些工具能更好地处理二进制数据的返回。

问题87：需要为计算机名为“iZe1n06qzepw311irjh2clZ”的服务器申请iServer 11i版本的正式许可文件。

11.1.0
【解决办法】技术支持人员已收到计算机名，并已受理该许可申请，将按流程提供对应的iServer 11i版本许可文件。

问题88：咨询如何将多个RVT模型文件合并发布为一个三维瓦片服务，是采用追加方式生成缓存，还是在GPA模型中需要设置多个RVT导入节点。

11.3.0
【解决办法】若多个RVT模型的项目基点一致，可在iServer的GPA服务中使用“迭代文件”算子进行批量处理。但为便于数据管理，建议将每个RVT文件单独发布为一个服务。

问题89：使用iServer GPA服务，通过“迭代文件”算子批量导入多个RVT文件生成三维瓦片时模型执行报错。检查输出目录，发现未成功生成scp缓存配置文件，仅有一个JSON文件。

12.0.0
【问题原因】1. iServer旧版本产品存在缺陷，导致批量生成瓦片失败。2. GPA模型中“合并生成瓦片”算子的参数设置不当。
【解决办法】1. 升级iServer到最新的双周版本：https://pan.baidu.com/s/1MzzE_whiFRABAA7KH0saPw?pwd=mf5c 提取码: mf5c；

2. 参考帮助文档，调整GPA模型中“合并生成瓦片”算子的参数（如显示模式、线程数、瓦片边长等）后重新执行。

问题90：咨询iServer产品进行版本升级的具体操作步骤，以及如何将旧版本中已发布的数据服务无缝迁移至新版本环境中，避免服务丢失。

12.0.0
【解决办法】1. 版本升级：停止旧版本iServer服务，解压新版本包后直接启动新服务即可。2. 服务迁移：在iServer停止状态下，将旧版本 iserver/webapps/iserver/WEB-INF/ 目录下的 iserver-services.xml 文件拷贝至新版本对应路径下。若服务涉及数据库，还需同时拷贝同级目录的 iserver-system.xml 文件。

问题91：将iServer服务配置文件迁移至新版本后，出现两个问题：1. 新环境中服务总数与旧版本不一致，数量偏少。2. 预览部分数据服务时，页面报错 cannot invoke “org.locationtech.jts…” because “targetGeometry” is null。

12.0.0
【问题原因】1. 服务数量问题：新版本iServer启动后，服务正在后台加载和发布，尚未全部完成。2. 服务预览报错：源数据本身存在问题，导致服务发布后几何对象为空。 【解决办法】1. 等待iServer日志稳定，服务全部加载完成后，服务数量即可恢复正常。2. 使用iDesktopX桌面软件打开源数据进行检查和修复，重新导出数据后再发布为服务。

问题92：用户在修改iServer配置以启用服务实例动态化管理后，发现有两个iServer实例的服务列表变为空，无法显示或访问任何服务，但组件和iServer日志中均未记录任何明显错误。

10.2.1
【问题原因】经过排查，问题根源大概率是原iServer部署包本身已损坏，而非配置修改所致。 【解决办法】使用全新的iServer部署包替换损坏的程序目录，然后按照迁移文档将原有的服务配置文件（如iserver-services.xml等）迁移至新目录中，重启后服务列表恢复正常。

问题93：咨询iServer矢量瓦片自动更新功能是否仅支持PostGIS数据库作为数据源进行管理。

11.3.0
【解决办法】确认了iServer的矢量瓦片自动更新功能目前仅支持使用PostGIS数据库管理数据。

问题94：项目需持续发布大量（初期4000+，每年新增约800个）A产品格式的紧凑型影像瓦片，每个瓦片作为一个独立服务。咨询如何设计一套可持续的方案，以避免因服务数量过多导致iServer性能下降、卡顿或内存溢出等问题。

11.3.0
【问题原因】在单个iServer节点上发布数千个服务会带来巨大的性能和管理压力，容易导致服务不稳定。 【解决办法】建议采用集群方案来分散压力。可以通过iServer自带的集群功能或使用iManager进行更专业的管理，将服务发布到多个iServer节点。当单个节点的服务数量达到预设阈值（如2000个）后，新的服务将被发布到集群中的其他节点，从而保证整个系统的稳定性和高可用性。

问题95：咨询SuperMap iServer产品是否有接口可以判断一个点对象是否落在指定面对象的地理范围内。

11.3.0
【解决办法】可以使用iServer提供的空间分析服务中的“相交分析”（Intersection Analysis）功能来实现该需求，通过判断点与面是否相交来确定其空间关系。

问题96：iServer更新许可文件并重启服务后，出现无法连接到达梦（Dameng）数据库的问题，导致数据源和相关服务均不可用。

11.3.0
【问题原因】具体原因未知，可能是许可更新或重启过程中导致原有数据库连接配置失效或缓存错误。 【解决办法】通过删除iServer中原有的数据源和地图服务，然后重新创建数据源连接并重新发布服务，可恢复正常。

问题97：使用MongoDB作为数据源发布的三维服务，在iDesktopX中可以正常加载，但在iServer服务预览页面不显示模型。经排查，另一台版本较高的iServer发布同样数据则可以正常显示。

11.3.0
【问题原因】iServer服务所在节点（核心区）版本较低，对来自MongoDB的三维服务兼容性不足。 【解决办法】将核心区的iServer实例更新至与托管区相同的高版本后，服务恢复正常预览。

问题98：同样使用CGCS2000坐标系并从0级开始切片的地图瓦片，发布为WMTS服务后，部分服务的接口地址中缺少"chinaPublicServicesCGCS2000"矩阵集标识，导致调用异常。

11.3.0
【问题原因】在发布WMTS服务时，未在服务组件的接口配置中勾选 “chinaPublicServicesCGCS2000” 瓦片矩阵集。 【解决办法】进入iServer管理器，找到对应服务的“服务装配-接口”配置项，在WMTS 1.0.0接口的瓦片矩阵集列表中，勾选"chinaPublicServicesCGCS2000"并保存即可。

问题99：GIS平台某节点下的倾斜摄影三维服务突然无法在浏览器中预览显示。这些服务之前均可正常访问，怀疑与前一天的平台版本调整有关，但该问题随后又自行恢复。

11.3.0
【问题原因】问题原因不明确，可能是服务初始化的默认视角或网络波动导致。该问题可自行恢复。 【解决办法】在服务预览页面，尝试缩小地图视图范围，模型即可正常显示。问题后续未再复现。

问题100：需要获取SuperMap iServer 11i for 64位ARM架构的历史版本安装包的下载链接。

11.3.0
【解决办法】通过支持人员提供的百度网盘链接下载指定的iServer 11.3.0 for ARM64 版本。链接：https://pan.baidu.com/s/1xbv6s5vlbqw_uMg9J9hgJw?pwd=6655

问题101：咨询SuperMap iServer 11.3.0版本配置连接达梦（DM8）数据库的具体操作步骤和所需依赖。

11.3.0
【解决办法】1. 在部署iServer的服务器上安装达梦数据库客户端。 2. 将对应的达梦数据库驱动文件更新到iServer的相关目录中。

问题102：“直升机隐蔽路线分析”GPA模型执行速度过慢，分析一次耗时近5分钟，影响用户体验。经排查，主要耗时在于模型中动态计算山谷飞行区域的算子。

11.3.0
【问题原因】模型在每次运行时都需要动态进行地形分析以提取山谷、山脊线等信息，该过程计算量大，导致整体耗时较长。 【解决办法】对模型进行优化，将耗时的地形分析过程剥离出来。预先将分析区域的山脊线、飞行区域等中间数据制作好，并作为模型的静态输入参数。在模型运行时直接使用这些预处理好的数据，从而大大缩短分析时间。

问题103：“机降地域模型”GPA在使用动态绘制的点位（MultiPoint GeoJSON）作为输入时，模型执行失败。日志显示失败的算子为“河流缓冲区”。

11.3.0
【问题原因】当模型输入的动态点位所确定的分析区域内，不包含任何河流数据时，后续的“河流缓冲区”算子会因为输入的数据集为空而执行失败，导致整个模型中断。 【解决办法】修改GPA模型，在缓冲区分析之前增加一个“条件分组”节点。该节点用于判断经过裁剪后的河流数据集是否为空。如果为空，则绕过缓冲区分析步骤；如果不为空，则正常执行，从而增强了模型的容错性。

问题104：GPA模型返回结果的JSON中，几何对象的类型不统一，同时存在 MultiPolygon 和 Polygon 两种，希望能统一为一种，以便前端处理。

11.3.0
【问题原因】这是GIS数据中正常的几何类型。Polygon代表简单的面对象，而MultiPolygon代表由多个分离的面（或包含岛洞）组成的复杂面对象。分析结果中出现哪种类型取决于实际生成的几何形状。 【解决办法】此为正常现象，非产品问题。建议前端或业务代码在解析结果时，增加对 MultiPolygon 和 Polygon 两种类型的兼容性处理。

问题105：在安装了Docker的Linux服务器上，使用许可工具licensetool.sh -cardid命令会返回多个MAC地址，不确定应该使用哪一个来申请正式许可。

11.3.0
【问题原因】在装有Docker的Linux系统上，会产生多个虚拟网卡，导致许可工具获取到多个MAC地址，其中包括虚拟网卡的MAC地址。 【解决办法】应使用与服务器物理网卡绑定的主IP地址对应的MAC地址来申请许可。可以通过 ip addr 等系统命令，找到服务器对外提供服务的IP地址所在的网卡信息，并使用该网卡的MAC地址。

问题106：优化后的“直升机隐蔽飞行路线”GPA模型，返回结果JSON中的value字段值从之前的整数（0, 1, 2）变成了浮点数（0.0, 1.0, 2.0），导致客户前端基于字符串的switch判断失效。

11.3.0
【问题原因】模型优化过程中，某个算子的处理导致结果数据集中字段的类型发生了变化，从整型变为了浮点型。 【解决办法】在iDesktop中打开该模型使用的数据源，找到对应的结果数据集，将其value字段的类型修改为整型，或者更新该列的值，将其转换为整数。

问题107：iServer处理自动化服务(GPA)中导入用于DEM斜坡单元处理的XML模型时无反应，服务管理页面左侧的工具和模型列表为空。

11.3.0
【问题原因】根据日志排查，iServer内置的GPA服务因端口（默认为8097）被其他进程占用，导致服务未能成功启动。 【解决办法】1. 修改iServer安装目录下的 geoprocessing.xml 文件，将GPA服务端口更换为其他未被占用的端口。 2. 或通过系统命令（如 netstat -aon）查找并结束占用该端口的进程，然后重启iServer服务。

问题108：为iServer配置安全策略，在修改iserver-all-*.jar包内的shiroUrls.ini文件后，导致服务启动失败或访问时报错。用户在10.2.1、11.1.1和12.0.1等多个版本上均遇到此问题。

10.2.1
【问题原因】iServer 10.x与11.x/12.x版本的后台管理页面资源路径结构不同，导致shiroUrls.ini的安全配置规则不兼容。 【解决办法】需根据iServer版本使用不同的配置规则。10.x版本使用一套配置，而11.x及以上版本需增加针对/resources/admin-ui/**路径的匿名访问规则。

问题109：咨询超图GIS平台软件前后端版本的兼容性，具体为12i版本的客户端是否能正常加载和使用由10i或11i版本的iServer发布的服务。

12.0.0
【解决办法】确认兼容。超图GIS平台12i版本的客户端产品具备良好的向后兼容性，可以正常加载和使用由10i和11i等旧版本iServer发布的服务。

问题110：在信创环境下的iServer中，通过服务管理页面上传文件后，文件列表为空，不显示已上传的成果。用户不清楚如何自定义文件上传的磁盘路径。

11.3.0
【问题原因】iServer上传文件路径中默认路径为（F:/工作），而服务器不存在该路径，导致失败
【解决办法】在上传文件界面点击首页，手动选择服务器路径进行上传数据

问题111：通过API重复调用iServer处理自动化（GPA）服务时，服务返回“数据集名称不合法”的错误，但在iServer管理页面手动执行则可以成功。

11.3.0
【问题原因】GPA模型中用于生成结果数据集的名称是固定的。当通过API重复调用时，第二次执行会因目标数据源中已存在同名数据集而创建失败。 【解决办法】修改处理自动化模型，在输出结果数据集的工具（如“栅格矢量化”）前，增加一个“获取日期字符串”的工具，并将该字符串拼接到输出数据集名称中，确保每次执行生成的名称都唯一。

问题112：调用iServer处理自动化（GPA）服务成功执行后，希望从客户端能直接获取分析生成的面要素结果，而非仅获得一个执行成功的状态通知。

11.3.0
【问题原因】GPA服务将结果写入了文件型数据源（如UDBX）。文件型数据源是独占式访问，当被GPA服务写入时会被锁定，无法同时作为数据服务发布以供客户端查询。 【解决办法】将GPA模型中使用的数据源更换为数据库型数据源（如PostgreSQL）。将该数据库型数据源同时用于GPA分析并将结果数据集发布为数据服务，这样前端在调用GPA执行后，可立即通过数据服务的查询接口获取到最新的分析结果。

问题113：iServer发布的三维服务，在服务列表页面点击“获取三维数据的配置文件”链接无响应，前端调用场景加载时报JSON解析错误，导致S3M模型图层加载失败。

11.3.0
【问题原因】首次发布服务时可能存在配置错误或服务缓存异常，具体原因未明确。
【解决办法】将原三维服务删除后，重新将工作空间发布为三维服务，问题得到解决。

问题114：Windows环境下安装的iServer 11.3.0，首次启动正常，但在重启电脑后，执行startup.bat脚本无法启动服务，命令行提示找不到catalina.bat相关错误。

11.3.0
【问题原因】iServer启动脚本依赖CATALINA_HOME环境变量来定位其内部Tomcat的路径，该环境变量未配置，导致重启后脚本无法正确定位文件。
【解决办法】在Windows系统环境变量中，手动添加变量CATALINA_HOME，其值设置为iServer安装路径下的bin目录。

问题115：iServer数据服务访问时返回400错误，提示“数据服务获取不到数据源”。多次重新发布服务后，问题依然存在，影响用户正常业务办理。

11.3.0
【问题原因】服务通过工作空间发布，工作空间引用的数据源中的数据已更新，但iServer服务实例未同步获取到最新的数据状态。 【解决办法】在iServer服务管理页面，找到对应的工作空间提供者，执行刷新操作，即可使数据服务恢复正常。

问题116：项目中不同类型的管线数据存储在各自独立的数据源中，在前端三维平台展示时，是否需要先将这些数据源合并？

11.3.0
【解决办法】不需要合并数据源。前端WebGIS平台（如iClient3D for WebGL）可以同时加载和显示来自不同服务地址的多个三维服务。只要确保各数据源中的数据地理坐标正确，即可在同一个三维场景中正确叠加展示。

问题117：用户咨询如何向其客户解释产品存在的某个安全漏洞，并寻求官方的修复方案或说明文档。

11.3.0
【解决办法】参考文档SuperMap iServer 0day漏洞修复方案

问题118：根据漏洞扫描报告，发现部署的SuperMap iServer 10.2.1版本存在安全漏洞，需要了解如何修复此漏洞以确保系统安全。

10.2.1
【问题原因】使用的iServer 10.2.1版本存在已知的安全漏洞。 【解决办法】该漏洞已在新版本中修复，需要将iServer升级至官方提供的已修复此漏洞的新版本（如11.0.1及以上版本）。

问题119：iServer中发布的工作空间服务，在刷新或重启服务后，工作空间内的部分地图未能同步显示在服务列表中，导致地图列表不完整。

11.3.0

【问题原因】iServer服务管理器中配置的工作空间文件路径不正确，指向了一个旧的或不完整的工作空间文件。 【解决办法】在iServer服务管理器中，重新指定并加载正确的工作空间文件路径，即可同步所有地图。

问题120：咨询iServer发布的数据服务中，如何为叠加分析的结果配置汇总统计表。用户希望能在服务层面直接实现统计功能，而不是通过前端代码二次开发。

11.3.0
【问题原因】iServer标准的数据服务中的叠加分析功能，本身不直接支持在服务配置中输出汇总统计表。 【解决办法】可通过两种方式实现：1. 在前端对数据服务返回的叠加分析结果进行编码，自行实现汇总统计逻辑。2. 在iDesktop中构建地理处理自动化（GPA）模型，将叠加分析与统计功能封装在一起，然后将模型发布为地理处理服务供前端调用。

问题121：部署在超算服务器上的iServer实例，在使用空间分析相关功能时提示“没有空间分析许可”，导致服务无法正常使用。

11.3.0
【问题原因】部署在超算服务器上的iServer软件许可中，未包含空间服务授权模块。 【解决办法】需要为当前部署的iServer申请并配置包含空间分析功能模块的正式许可。

问题122：用户访问产品配置页面时，系统提示“无权限”，导致无法正常访问和进行相关配置操作。

11.3.0

【问题原因】可能是浏览器缓存或Cookie信息异常导致的用户权限验证失败。 【解决办法】建议用户使用浏览器的无痕/隐私模式重新访问该配置页面，以绕过缓存和Cookie问题，即可正常加载。

问题123：用户为项目测试需要，申请一个SuperMap iServer 12i版本的试用许可文件。

12.0.0
【解决办法】用户提供了部署iServer的服务器计算机名，技术支持人员根据该计算机名生成了对应的试用许可文件并提供给用户使用。

问题124：用户报告超图iServer存在任意指令执行漏洞。攻击者可利用文件访问路径的双重编码解码缺陷，未授权访问配置文件，计算上传凭证后实现任意文件上传，从而获取服务器权限。

11.3.0
【问题原因】旧版本iServer产品在处理文件访问路径时存在双重编码解码缺陷，导致攻击者可未授权访问服务端配置文件，计算出上传凭证后实现任意文件上传，获取服务器权限。 【解决办法】升级iServer至已修复该漏洞的新版本。10i系列可升级至最新的10.2.1版本，11i系列可升级至最新的11.3.0版本。

问题125：SuperMap iServer服务在未登录的情况下即可被匿名预览和访问，如何配置访问权限以解决此安全问题，以及客户端在权限开启后应如何携带凭证进行访问。

11.3.0
【问题原因】iServer中的服务默认配置为允许匿名访问，因此无需登录即可预览和使用。 【解决办法】1. 在iServer的“服务管理”中，可以找到具体服务，修改其访问权限，取消“允许匿名访问”，并根据安全需求设置为需要“登录用户”或“指定角色”才能访问。 2. 客户端（前台）在请求需要权限的服务时，必须在请求中携带一个合法用户的Token作为访问凭证。

问题126：iServer服务在Windows环境下频繁意外崩溃。已配置的资源定时回收策略无效，需要排查根本原因，并提供一个能确保服务稳定运行或在异常后能自动恢复的方案。

11.3.0
【问题原因】通过日志分析，服务崩溃是由于iServer持续尝试连接PostgreSQL数据库但无法成功连接导致。 【解决办法】提供一个定时重启脚本作为保障机制。在Windows环境下，通过“任务计划程序”创建一个基本任务，配置该任务每日定时执行提供的重启脚本。脚本需根据实际iServer安装目录修改iservrDir变量。此方案可确保服务在发生异常崩溃后，能够于次日自动重启恢复。

问题127：使用超图桌面软件直接打开由第三方平台创建的PostGIS数据库时，数据集名称被自动命名为"模式名.表名"的格式。由于名称中的"."是iServer服务发布时的非法字符，且无法修改，导致这些数据无法成功发布为地图服务。

11.3.0
【问题原因】直接打开由第三方平台创建的PostGIS数据库，会因缺少超图软件所需的系统管理表（sm开头表），导致软件无法正确管理数据集元数据。这会使得数据集名称被解析为"模式名.表名"的格式，而"."字符在iServer中是不被支持的非法字符，从而导致服务发布失败。 【解决办法】1. 不应直接打开第三方创建的PostGIS库。应使用iDesktopX在另一个全新的、空的PostgreSQL数据库中，新建一个数据库型数据源。此操作会自动在库中创建超图所需的系统表。 2. 将原始数据库中的业务数据表，通过数据导入/导出的方式，迁移到这个新创建的、符合超图规范的数据源中。 3. 确认数据迁移无误后，即可在新数据源的基础上进行地图制作与服务发布。

问题128：在iServer 11.3.0版本中，对存储于PostgreSQL数据库中的数据集进行批量查询时，响应速度过慢，咨询是否有可行的优化方法。

11.3.0
【解决办法】参考iServer问题排查指南-性能不足排查流程进行处理：SuperMap iServer 排查指南

问题129：咨询前端调用iServer发布的GPA服务时，是否支持Token令牌的验证方式，以及请求中Cookie字段的获取方式。

11.3.0
【解决办法】1.前端调用需要安全认证的GPA服务时支持Token验证，可通过访问iServer的security/tokens接口生成Token。2.Cookie是浏览器与服务器之间用于会话管理的凭证，不建议手动获取或修改。

问题130：在iServer许可配置页面，只显示云许可和容器许可两种方式，没有出现常规的本地文件许可配置选项，导致无法配置本地许可。

11.3.0

【问题原因】许可驱动损坏
【解决办法】卸载许可驱动之后重装驱动即可.许可驱动下载地址：https://support.supermap.com/DownloadCenter/ProductPlatform.aspx，使用方式请参考博客文档第六点https://blog.csdn.net/supermapsupport/article/details/88966868

问题131：咨询iServer 12版本推荐配合使用的PostgreSQL数据库和PostGIS空间扩展的具体版本号。

12.0.0
【解决办法】关于iServer各版本所适配的PostgreSQL及PostGIS版本，详细信息可查阅产品安装包内自带或官网的在线帮助文档中的环境配置说明。

问题132：客户的电脑在浏览器中无法正常预览iServer发布的三维服务，提供了电脑配置信息，希望排查可能的原因。

11.3.0
【问题原因】客户电脑显卡性能不足。
【解决办法】
1、升级硬件性能，参考：
http://support.supermap.com.cn:8090/webgl/web/introduction/intro_3DWebgl.html#environment
推荐RTX4090Ti同等级的显卡，
2、硬件驱动优化参考：https://blog.csdn.net/supermapsupport/article/details/128440798
3、软件和数据的优化参考：https://blog.csdn.net/supermapsupport/article/details/128452333

问题133：为构建一个Web端的遥感变化检测系统，咨询除了“iServer标准版+机器学习模块+土地覆盖预训练模型+空间分析模块”外，是否有其他产品配置方案。

11.3.0
【解决办法】构建遥感变化检测系统的产品配置方案，除了基础配置外，还可以根据具体的业务场景（如城市扩张监测），考虑增配“建筑物变化检测预训练模型”产品。

问题134：iServer 11.3版本在启动过程中失败，日志提示找不到有效的许可文件或许可配置错误，导致服务无法正常启动。

11.3.0
【问题原因】许可更新错误，客户将之前的旧许可当做新许可放到了/opt/SuperMap/License目录下
【解决办法】将新申请的许可替换进去后正常

问题135：咨询是否必须要有“军用标号库”专项许可才能使用该功能，以及普通的iServer（i版）是否支持此功能。

11.3.0
【解决办法】使用军用标号库功能需要“动态标绘扩展模块”许可，该模块在iServer标准版及以上版本中提供。在12.0.0版本之前i版和m版许可通用，12.0.0及之后版本mServer需要独立的许可。

问题136：在iServer中发布动态地图服务时，选择“生成瓦片缓存”选项是否能提升浏览速度，以及当数据更新后，如何更新对应的瓦片缓存。

11.3.0
【解决办法】为动态服务生成瓦片缓存可以显著提高浏览速度。当源数据更新后，需要手动或通过服务接口清除旧的缓存文件，iServer会在下次访问时根据新数据自动生成新的瓦片。

问题137：使用Docker部署的iServer服务，运行时会频繁无响应，查看日志发现有异常，必须重启容器才能恢复正常。

11.3.0

【解决办法】在容器中部署iServer不建议使用硬件单机锁或文件许可，因为一旦容器重建或iServer镜像升级，新生成容器的机器信息与之前不同，导致之前的许可无法继续使用。
●内网环境中建议使用Web许可（私有云许可）或硬件网络锁；
●在线环境中建议使用Web许可（私有云许可）或OnLine许可（公有云许可）。

问题138：通过SuperMap iServer 11.3.0版本发布三维白膜场景服务后，在浏览器中预览时，场景模型出现一半黑色一半正常的异常显示问题。

11.3.0

【问题原因】iServer内置WebGL包问题
【解决办法】打开ise-representations-3d-11.3.0*.jar，找到\META-INF\resources\representations\realspace\iClient3DForWebGL并用官网下载的WebGL产品包替换

问题139：在iServer的GPA模型中执行矢量瓦片和栅格瓦片切图任务时，任务状态显示完成且进度为100%，但后台仍在持续生成文件，无法判断任务是否真实完成。

11.3.0
【问题原因】服务器磁盘性能不足，导致结果写入缓慢。
【解决办法】更换搭配高性能磁盘的服务器执行相同任务，任务进度与结果文件生成正常同步。

问题140：在iDesktop中搭建了一个GPA模型，并在iServer中将其配置为自动化处理服务，咨询如何将此工具发布成接口供前端应用程序调用。

11.3.0
【解决办法】发布REST-API后接口调用参考文档：https://help.supermap.com/iPortal/zh/Server_Service_Management/Geoprocessing/usingby_REST_API2.htm

问题141：在进行iServer 11.2版本扩展开发时，由于安全机制限制，启动iServer时服务报错，提示不允许加载自定义的配置类。

11.2.1

【问题原因】iServer基于安全考虑，默认不允许对未授权的自定义配置类进行反序列化操作。 【解决办法】使用com.supermap.iserver作为类名，以保证程序信任并允许自定义类的加载。

问题142：咨询iServer是否支持通过带参数的URL直接访问并打开具体的模型编辑页面。

11.3.0
【解决办法】可以通过调用<geoprocessing_uri>/gpmodeler/modelui这个GPA编辑模型的接口进入到GPA模型编辑界页面.如:http://172.16.15.203:8090/iserver/apps/gpmodeler/index.html

问题143：在服务器上解压iServer 12.0.1 for Linux x64版本后，启动时发生报错导致启动失败。

12.0.0

【问题原因】客户的操作系统是centos7.6,而iServerV12起已在文档明确说明不支持centos7.
【解决办法】降低版本到iServer11.3.0进行使用,或者升级到centos8.x再使用iServer12.0.1

问题144：在iServer GPA流程中，如何为数据添加一个时间戳字段以区分不同批次，或者如何将时间戳作为参数传入模型。

11.3.0

【解决办法】暂无时间戳算子，需要自己扩展一个获取时间戳的算子,来获取当前时间戳并提供时间值。

问题145：咨询iServer 11i及12i版本是否有使用到第三方图表库Highcharts。

11.3.0
【解决办法】iServer目前没有用到Highcharts软件。

问题146：在iServer平台中转发ArcGIS的遥感影像服务后，进行地图缩放操作时，预览的影像内容显示不正常。

11.3.0

【问题原因】存在历史地图缓存导致出图内容与预期不符。【解决办法】清除地图缓存后，iServer预览地图正常。

问题147：填挖方分析时，开挖范围大致相同而开挖深度不同时，计算出的挖方量几乎没有变化。该问题在iServer官网范例中也能复现。

11.3.0
【问题原因】范例中参数”开挖高程“的意义，用户理解错误，理解为了基于地形表面向地下开挖的距离
【解决办法】范例中该参数的意义为，填挖后填挖面的最终高程数值。

二、SuperMap iDesktopX

问题1：使用iDesktopX导入一个包含闭合二维多段线的DWG文件时，导入结果为线数据集，而非预期的面数据集。咨询如何在iDesktopX中将此类DWG数据直接导入为面状数据。

12.0.0
【问题原因】经确认，iDesktopX 12.0.1及更早版本在导入DWG功能中，尚不支持将“二维多段线”这种特定类型的闭合对象直接转换为面对象。 【解决办法】此功能增强已在后续版本中规划并实现，将在iDesktopX 12.1.0版本（预计5月底发布）中正式支持。当前临时解决方案为：1. 先将DWG文件正常导入为线数据集；2. 使用iDesktopX中的“线转面”功能将生成的闭合线数据转换为面数据集。

问题2：咨询如何使用iDesktopX将DEM和DOM数据叠加生成三维模型，并导出为OSGB格式。客户使用其他软件生成模型存在约400米高程偏差，希望使用超图软件验证。

11.3.0
【解决办法】在iDesktopX中使用【栅格影像生成三维模型】功能，可以直接选择OSGB作为瓦片类型来生成三维模型缓存。或者先生成默认的三维缓存，再将缓存转为模型数据集后导出为OSGB格式。

问题3：地图中包含多个面状数据图层，在小比例尺下显示时，顶层图层的要素会大量覆盖下层要素，导致视觉效果拥挤、不均衡，希望进行优化。

11.3.0
【解决办法】通过调整图层属性中的“对象最小尺寸”参数进行优化。在小比例尺下，尺寸小于该阈值的要素将不会被绘制，从而可以有效地过滤掉细小的图斑，减少地图的视觉混乱度，使整体显示效果更加清晰合理。

问题4：当用于生成栅格瓦片的数据源（UDB）中数据集数据量非常大时，咨询是否有相关设置或优化方法可以提升切图效率。

11.3.0
【解决办法】建议在执行切图任务前，首先对地图的显示性能进行检查和优化。具体的优化措施和高效的切图策略，可以参考官方帮助文档中的地图缓存生成建议：https://help.supermap.com/iDesktopX/zh/tutorial/MapTiles/AdviceAboutMapCache.html

问题5：在iDesktopX中进行数据编辑时，设置了“捕捉节点”功能，但在实际操作时光标无法自动捕捉到线上或面上的节点，导致功能不生效。

11.3.0
【解决办法】经测试并未复现此问题。用户因工作环境涉密无法提供远程协助，已向客户发送视频演示此功能使用方法，需同时开启图层的捕捉开关和地图的捕捉总开关。

问题6：在三维场景中使用“生成DOM”功能时，生成的影像清晰度远低于原始影像，显得模糊。尝试提高分辨率或降低相机高度后，无法生成DOM或生成纯绿色图片。

11.3.0

【问题原因】生成的DOM呈纯绿色是因为设置的相机高度低于了场景中模型（如倾斜摄影）的最低高程，导致相机在地表以下无法正确渲染。 【解决办法】确保生成DOM时设置的相机高度要高于场景内所有模型的最高高程。清晰度可通过调整分辨率参数来优化，分辨率值越小越清晰。

问题7：由于iClient3D for WebGL无法直接加载晕渲图层，项目需要替代方案。现已获取到DEM数据，请求支持提供使用该数据制作晕渲图层并发布的具体方法。

11.3.0
【问题原因】iClient3D for WebGL不支持加载客户矢量服务中的hillshade（晕渲）图层。 【解决办法】通过腾讯会议进行了演示和讲解，并提供了录屏。具体步骤为：使用iDesktopX，基于项目提供的DEM原始数据，生成三维晕渲地图瓦片，然后通过iServer发布为地图服务供前端加载。

问题8：客户需要iDesktopX 12.0.1版本支持加载影像服务功能，并且在添加影像服务至新地图时能自动定位到影像数据区域。

12.0.0
【解决办法】升级iDesktopX至12.0.1（260302）双周包版本即可支持加载影像服务。为支持自动定位到数据区域，需同时将iServer升级至11.3.0（260204）双周包版本。

问题9：咨询三调地类图斑（DLTB）数据是否有现成的风格化方案，并反馈在iDesktopX中加载一个风格化XML文件失败的问题。

11.3.0
【问题原因】加载专题图模板（XML）失败是因为缺少配套的符号库文件（.sym）。 【解决办法】1. iDesktopX自带三调符号库。2. 将专题图模板配套的符号库文件（.sym）与模板文件（.xml）放在同一目录并保持同名，即可成功导入。

问题10：在iDesktopX中构建地理处理模型（GPA）时，对于数据裁剪算子，询问是否还需要连接输入、输出、开始和结束节点。

11.3.0
【解决办法】在构建GPA模型时，可以直接在数据裁剪算子的参数面板中设置输入和输出参数，不强制要求连接独立的输入输出参数节点。

问题11：咨询如何快速地从多个大数据集中分别选取一部分数据，并合并复制到一个新的数据集中，以用于开发测试。

11.3.0
【解决办法】通过在地图中选择部分对象后，对图层右键执行“复制”，然后在目标数据源中“粘贴”的方式解决了该问题。

问题12：在udbx数据源中与影像叠加显示正常的数据，导出为shp格式后，坐标发生偏移，无法与影像正确叠加。

11.3.0
【问题原因】矢量数据集的坐标系EPSG编码解析错误，导致导出时坐标转换出现问题。 【解决办法】在iDesktopX中为该数据集重新设置正确的坐标系（EPSG:4528），然后再次执行导出为SHP文件操作。

问题13：咨询在将GIS数据从Oracle数据库迁移到人大金仓数据库时，是否可以直接使用数据库工具迁移超图的系统表（如smregister表）。

11.3.0
【问题原因】不同类型的数据库，其超图系统表的内部结构和依赖可能存在差异。直接迁移系统表可能导致索引丢失或数据结构不兼容。 【解决办法】推荐使用iDesktopX作为数据迁移工具。在iDesktopX中分别连接源库和目标库，通过复制粘贴的方式迁移数据集，以确保系统表的正确生成和数据完整性。

问题14：咨询iDesktopX产品关于对话框中的试用许可信息，左侧蓝框内的内容是否可以修改或删除，以及激活正式许可后该区域会如何显示。

11.3.0

【解决办法】该许可信息选项卡可以通过配置进行隐藏。如果切换为正式许可，该区域将不再显示试用剩余天数等信息。

问题15：在iDesktopX的DOM生产流程中，已正确设置全色影像和多光谱影像的文件夹路径，但在运行时，系统仍然弹出手动文件匹配对话框。

12.0.0
【问题原因】全色影像和多光谱影像未能根据文件名等规则自动匹配成功。 【解决办法】检查两个影像文件夹下的文件，确保存在可以相互匹配的同名或有关联命名的影像对。

问题16：在Linux版本的iDesktopX中配置Python环境时，配置文件中读取的是.exe后缀的可执行文件，用户担心这在Linux系统下会导致无法正确识别Conda环境。

11.3.0
【解决办法】此为正常现象。用户只需将Linux版本的Python组件环境包（包含无后缀的python可执行文件）放置在指定目录，iDesktopX会自动识别并正确调用，无需担心.exe的显示问题。

问题17：用户在进行字段更新操作时，使用表达式更新字段值失败。从操作现象看，可能是在字段计算器中书写了不正确的赋值表达式。

11.3.0
【问题原因】用户在字段计算器中编写了包含“等于”号的赋值表达式，而工具仅需要运算表达式本身。 【解决办法】在字段更新或计算功能中，直接写入运算表达式即可，无需添加“等于”号。

问题18：用户在使用参数化建模功能绘制管井时，方形管井模型无法成功生成。用户提供了数据文件以供分析。

11.3.0
【问题原因】绘制方形管井时，当井盖类型为方形、井室为非圆形时，需要填写所有必填参数，如井盖长宽、关联井室面等，用户未提供所有必填参数。 【解决办法】在参数化建模界面，当井盖类型为方形时，必须设置井盖长度和宽度；当井室为非圆形时，需要关联井室面数据集。

问题19：用户将FBX模型作为管井的点符号使用，希望模型的显示高度能够根据数据集中的某个属性字段值进行动态拉伸。

11.3.0
【解决办法】通过制作“自定义专题图”来实现。在自定义专题图的样式设置中，将点符号的“Z轴缩放”参数与指定的属性字段进行绑定，即可实现模型高度随属性值变化的动态显示效果。

问题20：用户询问如何在三维场景中创建和显示方形截面的管线，而不是默认的圆形管线。

11.3.0
【解决办法】1. 在三维线型符号库中，新建一个方形管线符号并设置其参数。2. 在管线数据集中，使用一个字段存储该方形符号的ID。3. 为管线图层制作自定义专题图，专题图的样式基于存储符号ID的字段进行设置。

问题21：部分三维模型数据在桌面端（iDesktopX）中打开只显示为一串点，使用组件发布服务进行转换也失败，无法正常加载和显示模型。

11.3.0

【问题原因】12版本的iDesktopx导入dng时，会将实例化的模型导入为三维点外挂模型【解决办法】导入成功后使用点集生成三维缓存外挂模型功能生成三维缓存，然后加载到场景中查看模型

问题22：使用带有自定义坐标系的点外挂模型数据，在桌面端生成三维缓存时，目标坐标系应如何选择才能保证模型最终位置正确。

11.3.0
【问题原因】用户对不同坐标系下模型生成缓存的机制不理解。 【解决办法】正确的流程是：1. 导入数据时为模型数据集设置其原始的自定义坐标系。2. 右键数据集生成缓存时，在目标坐标系选项中选择一个标准地理坐标系（如CGCS2000，EPSG:4490）。产品会自动完成坐标变换，确保缓存位置正确。

问题23：咨询iDesktopX中，是否可以通过修改配置文件的方式，将“影像”(Imagery)功能选项卡从主界面上隐藏。

11.3.0

【解决办法】在iDesktopX安装目录的workEnvironment\Default_EN_US\（或对应语言）路径下，找到Desktop.Ortho.config配置文件，删除其中定义的Imagery选项卡相关的XML代码（约19到123行）。

问题24：在iDesktopX的GPA中，使用“融合”(dissolve)工具时，无法选择其上一个工具（如相交）输出结果中的字段作为融合依据字段。

12.0.0

【问题原因】可能是GPA画布渲染或工具参数加载的偶然问题。 【解决办法】在GPA画布中删除该“融合”工具节点，然后从工具箱中重新拖入一个新的“融合”工具，并连接数据流，即可正常选择字段。

问题25：用户希望将数据源中多个已设置投影坐标系的数据集，批量转换为无投影的平面坐标系。

11.3.0
【解决办法】使用iDesktopX中的“地理处理建模”功能：1. 新建模型，拖入“迭代数据集”和“重设坐标系”算子。2. 连接两个算子。3. 设置“迭代数据集”的参数，指定数据源。4. 设置“重设坐标系”的参数，将目标坐标系设置为“平面坐标系/平面无投影”。5. 执行模型即可。

问题26：用户询问如何在地图或场景中框选多个点对象，并一次性在属性表中查看这些被选中对象的属性信息。

11.3.0
【问题原因】用户在工作空间管理器的数据集上右键，而不是在图层管理器中的图层上右键，因此找不到“关联浏览”功能。 【解决办法】1. 将数据集添加到地图中，在图层管理器中找到对应图层。2. 在图层上右键，选择“关联浏览属性表”。3. 按住Shift键进行多选，两个窗口的选中状态会实时同步。

问题27：咨询在Linux版本的iDesktopX中，如何通过脚本或配置文件的方式预先配置Conda机器学习环境，以便于在打包镜像时实现自动化配置。

11.3.0
【解决办法】可以将预先配置好的Conda环境文件夹，直接替换或放置到iDesktopX安装目录下的support/MiniConda/路径中，软件启动时会自动识别，无需修改配置文件。

问题28：咨询如何获取最新版本的 SuperMap iDesktopX 12.0 的安装包。

12.0.0
【解决办法】SuperMap 官方产品安装包统一在官网下载中心提供下载，访问官方下载中心链接即可获取：https://support.supermap.com/DownloadCenter/ProductPlatform.aspx

问题29：用户需要为其计算机（名称：DESKTOP-FQQAR7R）申请一个iDesktopX产品的试用许可文件，以便进行软件的评估和使用。

11.3.0
【解决办法】根据用户提供的计算机名“DESKTOP-FQQAR7R”，为其生成并提供了对应的iDesktopX产品试用许可文件。

问题30：使用iDesktopX进行管井建模时，处理结果的属性表虽然有数据，但在三维场景中双击定位关联对象时，无法查看到生成的井模型，表明模型实体生成失败或存在问题。

12.0.0
【问题原因】iDesktopX产品在12.0.1版本前，管井建模功能存在缺陷，导致模型实体生成失败，仅生成了属性记录。 【解决办法】升级iDesktopX至官方提供的12.0.1最新双周包版本。新版本已修复该问题，并优化了管井建模的参数。

问题31：用户询问下载的临时iDesktopX版本是否会与电脑上已安装的正式版本产生冲突，以及是否可以同时存在。

11.3.0
【问题原因】iDesktopX的绿色免安装包不会与已安装版本冲突。用户使用的是试用许可，支持同时运行多个桌面程序实例。 【解决办法】提供的临时版本是绿色免安装版本，无需卸载已有的iDesktopX版本，二者可以同时存在和使用。

问题32：用户在学习管线和管点参数化建模功能时，希望技术支持能提供一份视频教程中使用的原始示例xlsx表格文件作为参考。

11.3.0
【解决办法】已为用户提供了参数化建模功能所使用的示例xlsx数据表格。

问题33：咨询如何快速地将一个包含25万个面要素的图层合并成一个大的面要素，以及如果不进行合并，是否能直接用该图层与另一个26万个面的图层进行叠加分析。

11.3.0
【解决办法】可以直接使用25万个面的图层与另一图层进行叠加分析，无需预先执行合并操作。同时，技术支持指出，如果面要素之间不是完全邻接，不建议将它们合并成一个单一的面对象。

问题34：用户希望将多个不同udbx数据源文件中的数据集（如点、线、网络数据集等）合并到同一个数据源中。

11.3.0
【解决办法】1. 在同一个iDesktopX工作空间中，同时打开多个udbx数据源。 2. 将需要合并的数据集从源数据源中复制，然后粘贴到目标数据源中。 3. 对于同类型的简单数据集，可以使用“追加行”功能将记录合并到一个数据集中。

问题35：用户使用点数据通过起终点号连接生成线数据时，发现部分数据只有起点号没有终点号，询问是否会影响线的生成。

11.3.0
【问题原因】通过起终点ID构线功能，需要成对的起终点信息才能生成一条线。 【解决办法】是的，如果一个点只有起点号而没有对应的终点号，它将无法构成一条完整的线，除非它本身就是一条线段的末端点。构线前需要确保数据中起终点ID能够正确配对。

问题36：用户咨询之前提到的“通过参数构建管井模型”功能优化后的新软件版本何时能提供，以便进行验证。

11.3.0
【解决办法】产品研发部门已完成对“通过参数构建管井模型”功能的修改。已提供一个临时桌面版本供用户验证，下载链接: https://pan.baidu.com/s/1jGphy0KI4NYeRgbuvt8nXw?pwd=6655 提取码: 6655。

问题37：在iDesktopX中，数据集在空间管理器中可见，但在地图模板中进行数据集替换时，却无法找到对应的数据，导致替换失败。

11.3.0
【解决办法】通过远程视频解决，在地图模版中重新指定数据集时能找到对应的数据

问题38：在桌面软件中制作单值专题图后，希望对所有子项批量调整图层的填充透明度，但不清楚具体操作方法。

11.3.0
【解决办法】在图层管理器中，可以对单值专题图进行批量样式设置。具体步骤如下：1. 在图层管理器中全选所有单值子项；2. 点击“风格”按钮打开风格设置面板；3. 勾选“填充风格”下的“透明度”选项；4. 修改透明度值后点击确认即可应用到所有选中子项。

问题39：咨询如何在桌面软件中进行地图制图输出，要求包含图廓、图例、指北针等地图整饰元素，并生成最终的地图图片或文档。

11.3.0
【解决办法】使用iDesktopX的布局功能可以实现标准化的地图制图输出。通过“新建布局”，可以在布局窗口中添加地图、图例、指北针、比例尺等元素，排版后即可导出为图片或PDF等格式。详细操作可参考官方帮助文档：https://help.supermap.com/iDesktopX/zh/tutorial/Layout/Basic.html

问题40：用户反馈在iDesktopX 12i中使用【栅格影像生成三维模型】功能时，发现功能不可用（未显示或灰色）。咨询该功能所需的具体许可模块以及功能置灰的原因。

12.0.0
【问题原因】1. 功能未显示是由于缺少“三维地理设计”许可模块。2. 功能置灰是由于当前工作空间未加载栅格或影像数据集，导致功能未被激活。 【解决办法】1. 启动iDesktopX时需勾选并占用“三维地理设计”许可。2. 在工作空间中加载栅格或影像数据集后即可使用该功能。

问题41：用户在iDesktopX中构建三维网络数据集后，在工作空间管理器中只看到了点数据集，认为线数据集（弧段）丢失或生成失败。

11.3.0
【问题原因】用户对网络数据集的结构不理解。网络数据集是一个复合数据集，在工作空间中显示为一个主节点，展开后才可见其包含的线（弧段）和节点两个子数据集。 【解决办法】网络数据集是一个包含线（弧段）和节点的复合数据集。在工作空间管理器中，点击网络数据集旁的展开图标，即可看到其包含的线数据集和点数据集。

问题42：用户在三维管线场景中，希望给管线设置贴图的同时，保留管点的自适应符号效果。但发现使用“新建批量管线三维符号”无法设置贴图，而使用“新建管线三维符号”则会丢失自适应管点。

11.3.0
【解决办法】在管点图层上右键，使用“关联图层风格”功能，将其风格关联到对应的管线图层上，即可同时实现管线贴图与自适应管点符号。

问题43：咨询TIF格式的栅格数据是否可以在SuperMap iDesktopX中按照栅格值进行分级设色，并询问具体的操作实现方法。

11.3.0
【解决办法】在iDesktopX中，可以对TIF栅格数据图层制作专题图，通过设置图层属性中的颜色方案，实现按栅格值进行分级设色。

问题44：用户在使用iDesktopX布局时遇到两个问题：1. 地图比例尺显示不准确，特定尺寸的地理范围在预期比例尺下无法完全显示。2. 使用模板出图时，布局中的比例尺控件在不同地图比例尺下大小固定，不随之变化。

11.3.0
【问题原因】旧版本桌面的比例尺没有自适应地图【解决办法】最新版本的桌面已解决该问题,需要在基本属性中勾选自适应地图

问题45：用户在内网环境使用11.3.0版本，需要对大批量倾斜摄影数据进行处理，希望获得一份标准的数据操作方案或确定的参数建议文档，因为产品自带的帮助文档无法访问。

11.3.0
【问题原因】内网环境无法访问产品自带的在线帮助文档。 【解决办法】技术支持人员提供了一份包含倾斜摄影数据处理参数建议的在线文档，供用户参考。

问题46：对200多GB的倾斜摄影模型进行入库处理，为减小数据量，纹理压缩参数选择了CRN_DXT5，处理耗时已近24小时，想确认该参数选择是否正确，以及处理耗时是否正常。

11.3.0
【问题原因】用户对CRN_DXT5压缩算法的特性不了解。 【解决办法】CRN_DXT5是高压缩比的纹理压缩格式，其处理时间本身就比其他格式长，但对分辨率影响极小，属于正常现象。通过检查磁盘读写状态，确认进程仍在正常运行，建议用户耐心等待处理完成。

问题47：在进行倾斜摄影数据入库时，咨询“轻量化”选项是否只影响最终文件大小，以及勾选后是否也会导致处理时间大幅增加。

11.3.0
【解决办法】
1、时间会增加
2、最后的文件大小也会有变化，但测试时没有关注这个实际变化大小。

问题48：咨询在对倾斜摄影模型进行预处理后，入库时是否还有必要勾选“纹理重映射”选项，以及该选项对处理时间的影响。

11.3.0
【问题原因】不清楚“纹理重映射”功能与预处理操作的区别。 【解决办法】技术支持解释：数据预处理主要检查纹理大小和冗余，而纹理重映射则处理纹理冗余和拼接问题。如果对数据质量不放心，建议勾选。同时明确该操作会增加处理时间，具体增量与数据情况有关。

问题49：咨询处理DEM和DSM数据的通用优化、检查操作流程。用户理解的流程为：导入数据集 -> 生成场景缓存 -> 合并TIN数据 -> 发布服务，希望确认该流程是否正确。

11.3.0
【解决办法】技术支持确认了用户提出的处理流程是正确的。并补充建议，在处理前可以在iDesktopX中加载数据，检查是否存在凹陷、异常凸起（如高程超过8848或为负数）等异常值。

问题50：在处理倾斜摄影数据时，发现相关文档中未提及法线生成。咨询倾斜模型入库时是否需要生成法线。

11.3.0
【解决办法】如果后续需要基于该数据进行坡度、坡向等三维地形分析，则必须在生成缓存时勾选法线选项。如果仅用于浏览展示，则不是必须项。

问题51：用户的DEM数据坐标系为西安80坐标系（自定义37带），咨询是否需要转换为CGCS2000地理坐标系（EPSG:4490）。

11.3.0
【解决办法】需要进行坐标转换，统一到标准的地理坐标系或投影坐标系，以便于多源数据叠加和三维场景加载。

问题52：对DEM数据集进行坐标转换后，软件提示数据集过大，建议创建影像金字塔。咨询创建金字塔时直接使用默认参数是否可以。

11.3.0
【解决办法】针对大数据量栅格或影像数据，为提升显示效率而创建影像金字塔时，通常情况下使用默认参数即可满足需求。

问题53：如果地形数据后续需要用于三维分析，应该生成数据集缓存还是场景缓存？并询问这两种缓存方式在生成时间和内存占用上是否有区别。

11.3.0
【解决办法】两种方式本质上没有区别。关键在于，若要用于三维分析，生成缓存时必须勾选“带法线”的选项。用户发现从数据集右键菜单生成的缓存有此选项，而从场景生成缓存没有，因此选择从数据集生成缓存。

问题54：咨询处理DOM数据的标准流程。用户将多块DOM制作成镶嵌数据集后，生成了地图瓦片（SCI），询问是否能直接用此SCI文件发布为UGCV5瓦片服务。

11.3.0
【解决办法】用户采用的“镶嵌数据集 -> 生成地图瓦片 -> 发布地图服务”的流程是正确的，特别适用于DOM数量众多的情况。技术支持补充，如果DOM数量少，也可以直接生成三维缓存进行发布。

问题55：在iDesktopX中导入点云数据时，选择存放LAS文件的文件夹后，导入对话框无任何响应，无法读取文件列表。

11.3.0
【问题原因】可能是导入功能对特定数据结构或数量的文件存在兼容性问题。 【解决办法】建议跳过导入数据集的步骤，直接使用“生成点云缓存”功能，在功能界面中直接添加LAS文件或文件夹来生成三维缓存。

问题56：咨询有无官方推荐的点云数据分类赋色方案（RGB值），因为用户认为默认的或自己搭配的颜色效果不佳。

11.3.0
【问题原因】用户的原始点云数据不含RGB颜色信息，需要后处理赋色。 【解决办法】在iDesktopX中，可以通过对点云图层使用“分层设色”专题图功能，基于“类别”等特征值字段进行赋色。用户可以手动修改颜色方案（颜色表），以达到期望的视觉效果。

问题57：使用iDesktopX对TDOM镶嵌数据集进行多任务地图瓦片切图，切到56%左右时，CPU占用率骤降，进度条长时间不动，疑似进程卡死。查看输出目录有错误日志。

11.3.0
【问题原因】可能是由于镶嵌数据集启用了单幅大影像模式，在处理到特定数据时出现异常导致切图进程中断。 【解决办法】在iDesktopX安装目录的bin\SuperMap.xml配置文件中，找到MosaicBuildSingleEnabled节点，将其值设置为false，关闭单幅大影像模式，然后重启桌面软件重新进行切图任务。

问题58：使用iDesktopX对包含模型数据集的三维场景直接生成缓存时，产出的缓存中部分模型会丢失。

11.3.0
【问题原因】旧版iDesktopX在处理大数据量模型时，默认的LOD（层次细节）参数设置不合理，导致生成缓存时部分模型被错误地舍弃。 【解决办法】1. 升级到最新的iDesktopX 12.0.1双周版本。2. 在生成缓存时，为模型数据集手动设置合适的LOD参数。

问题59：模型数据生成三维缓存后，在场景中进行浏览时出现严重的闪面（Z-fighting）现象，咨询原因和优化方法。

11.3.0
【问题原因】该现象是由于模型数据本身存在共面或距离极近的面，在三维渲染时因深度缓冲精度问题导致无法区分前后，从而产生闪烁。 【解决办法】该问题需从源头数据层面处理。在生成缓存前，应使用建模软件（如3ds Max）对模型进行修复，消除或错开共面的部分。

问题60：咨询如何在iDesktopX三维场景中为SHP点图层设置自定义图标并发布为三维服务。发布后在浏览器中预览时，自定义图标不显示。

11.3.0
【问题原因】发布的三维服务，其场景中的图层名包含特殊字符（“@“和”#”），导致浏览器端请求瓦片数据时URL解析失败。 【解决办法】1. 在iDesktopX中，为点图层制作自定义专题图，风格选择“图标文件”。2. 生成场景缓存时，取消勾选“点外挂”参数。3. 将场景中所有图层的名称修改为不含特殊字符的纯英文或数字。4. 重新生成场景缓存并发布三维服务。

问题61：在iDesktopX的地理处理建模（GPA）中，使用“字符串”变量指定一个包含空格的文件夹路径，再连接“新建数据源”工具时，模型执行失败。

12.0.0
【问题原因】工具执行时，输入的文件或文件夹路径参数不符合系统命名规范，路径中包含了空格等特殊字符导致解析失败。 【解决办法】确保所有作为参数的文件夹或文件路径符合操作系统的命名规则，避免使用空格等特殊字符。

问题62：咨询在桌面产品中，如何为World示范数据中的每个国家面要素快速批量添加一个表示其所属大洲的属性字段。

11.3.0
【解决办法】技术支持人员提供了一套操作方案（通过视频演示），具体步骤可能涉及空间连接或按位置选择等功能，可高效完成批量赋值。用户确认方案可行。

问题63：使用iDesktopX的点云生成瓦片功能时，当输入的LAS文件数量超过100个时，无法正常生成配置文件（scp）。同时咨询如何合并分批处理生成的瓦片结果。

12.0.0
【问题原因】文件数量限制问题，经研发确认产品无此限制，可能与机器硬件或总点数有关。 【解决办法】1. 对于合并问题，可以使用嵌套scp文件的方式将多个scp成果合并为一个，或在生成时选择“追加”模式。2. 对于生成失败问题，建议检查硬件资源，并确认总点数是否过大。

问题64：使用iDesktopX的“生成嵌套SCP”功能时，合并部分SCP文件失败，咨询该功能适用的数据及合并失败的原因。

11.3.0
【问题原因】合并的多个三维瓦片缓存（SCP）文件不在同一目录下。 【解决办法】需要将待合并的多个三维瓦片缓存文件放置在同一个文件夹内，并将输出路径也设置为该文件夹。

问题65：使用iDesktopX创建球面场景时，软件立即崩溃，咨询可能的原因以及该功能是否对硬件（如显卡）有要求。

11.3.0
【问题原因】创建和显示三维球面场景需要图形处理器（GPU）进行渲染，当前环境的显卡性能不足或驱动不兼容。 【解决办法】该功能需要独立显卡支持，或者性能较好的核心显卡也可以。

问题66：使用iDesktopX打开部分模型文件时，模型显示为一串点，无法正常渲染，并且通过组件发布也失败。

12.0.0
【问题原因】点集生成瓦片外挂模型时候未选择坐标系 【解决办法】点集生成瓦片外挂模型时，勾选转换坐标系，选择对应地理坐标系进行生成缓存。

问题67：用户在项目现场的Windows环境下安装iDesktop 11.3时遇到两个问题：1. 运行许可中心程序SuperMap.LicenseCenter(for .NET 4.0).exe时直接报错；2. 软件在某些操作下会发生崩溃。

11.3.0
【解决办法】针对许可报错问题，建议尝试将离线试用许可文件直接放置到C:\Program Files\Common Files\SuperMap\License目录下。针对崩溃问题，建议按照以下博客重新配置显卡https://blog.csdn.net/supermapsupport/article/details/128440798。

问题68：需要为两台计算机（DESKTOP-J2G93T5 和 czsm113）申请iDesktopX 11i版本的正式许可文件。

11.1.0
【解决办法】技术支持人员已收到计算机名，并已生成并提供了对应的iDesktopX 11i版本许可文件。

问题69：用户将ArcMap的地图迁移至SuperMap iDesktopX后，发现水系面图层的文本注记显示得过于密集，咨询调整注记密度的方法。

11.3.0
【解决办法】建议用户在专题图属性设置中，尝试取消勾选两个与注记相关的选项来降低注记的显示密度，具体操作已通过截图指导。

问题70：用户使用iDesktopX生成的矢量瓦片，在Web端加载显示时，效果与桌面端差异巨大，表现在小比例尺下注记不显示，放大后道路也不显示。

11.3.0
【问题原因】可能是地图中设置了矢量瓦片不支持的样式风格或参数，导致切片后部分要素在特定比例尺下无法正常显示。 【解决办法】请用户参考官方帮助文档《矢量瓦片使用注意事项》（https://help.supermap.com/iDesktopX/zh/tutorial/MapTiles/VectorTileTips.html），检查并修改地图样式，确保所有设置都符合矢量瓦片生成规范。

问题71：用户咨询如何处理一个1.4T大小的TIF影像文件。询问iDesktopX是否能直接打开、导入UDBX是否有大小限制，以及如何安全地将其切片发布为服务。

11.3.0
【解决办法】对于超大影像文件，无需导入数据源。建议使用镶嵌数据集进行管理，然后基于镶嵌数据集生成地图瓦片进行发布。

问题72：用户有一个TXT文件，其中包含节点数过多（超过4000个）的面数据，导致无法直接转换为CSV或其他格式导入。咨询如何将此大数据量的面坐标文本转换为矢量面数据。

11.3.0
【问题原因】数据量过大，单个面对象节点数过多，超出常规处理工具的限制。 【解决办法】手动编辑TXT文件，将单个面对象的坐标点串拆分为多个部分，分别存为多个TXT文件。注意确保每个拆分后的部分都能构成一个闭合的面（首尾坐标相同）。然后将这些TXT文件分别导入为矢量数据，最后在桌面软件中将生成多个面要素进行合并。

问题73：如何在iDesktopX中处理mesh模型，例如打开模型并提取其顶部或底部高程等相关属性信息？

11.3.0
【解决办法】1. SuperMap iDesktopX不支持直接导入mesh模型，支持的模型格式可参考官方帮助文档中的“数据导入导出支持的格式”章节，文档地址：https://help.supermap.com/iDesktopX/zh/
2.需要将支持的模型数据导入到SuperMap iDesktopX中生成模型数据集，使用“属性提取”功能，可以提取模型数据集的顶部、底部高程等属性。

问题74：如何将ArcGIS生成的地图瓦片或TPK切片包，转换为超图支持的格式，并将其存储到MongoDB数据库中？

11.3.0
【解决办法】使用SuperMap iDesktopX桌面软件中的“工具箱-数据迁移-瓦片迁移”功能。该功能支持将ArcGIS地图瓦片和TPK切片包作为源，在参数设置面板中，可以将目标瓦片的存储类型设置为MongoDB，执行即可完成转换和入库。

问题75：在iDesktopX中使用“更新列”功能时，希望截取一个文本字段值的右边5位来更新目标字段，但使用right函数未能成功。

11.3.0
【问题原因】用户可能使用了错误的函数或表达式。 【解决办法】在“更新列”功能的表达式中使用 Right([字段名], 5) 函数即可正确截取字段值右侧的5位字符。

问题76：客户需要使用DEM和DOM数据在iDesktopX中生成三维模型，并导出为OSGB格式。客户使用其他软件生成时存在较大的高程偏差，希望获取超图软件的推荐操作流程。

11.3.0
【解决办法】在iDesktopX中，可以使用“三维分析-栅格分析-栅格影像生成三维模型”功能。在该功能中，可以直接设置输出的瓦片类型为OSGB，一步到位地生成所需格式的三维模型。

问题77：在iDesktopX 11.3.0版本中，如何连接到一个使用了自定义模式（schema）的人大金仓（Kingbase）数据库。

11.3.0
【解决办法】连接使用了自定义模式的人大金仓数据库时，需要在数据源连接参数中进行相应的设置。具体操作步骤可以参考官方提供的教学短视频：https://weixin.qq.com/sph/A6ADrRhR4

问题78：寻求关于高斯泼溅（Gaussian Splatting）数据（通常为*.ply格式）在超图产品中应用的技术支持。

11.3.0
【解决办法】使用工具箱中“3DGS数据生成瓦片”功能，实现高斯泼溅数据对接；后续通过iServer发布为三维服务，使用 SuperMap iClient3D for WebGL v12 版本加载即可

问题79：同一份栅格影像数据，在ArcGIS中打开显示为彩色，但在SuperMap iDesktopX中打开却显示为灰度图，咨询如何恢复其原有的彩色显示。

11.3.0
【解决办法】在iDesktopX中，栅格图层默认可能以灰度拉伸方式显示。可以在图层管理器中右键单击该栅格图层，进入“风格设置”，将其拉伸方式修改为“RGB合成”或调整颜色表，即可恢复彩色显示。

问题80：咨询在iDesktopX的追踪分析功能中，用于定义管网或水网流向的“流向字段”，其属性值的具体定义规则或编码方式是什么。

11.3.0

【解决办法】参考https://help.supermap.com/iDesktopX/1130/zh/tutorial/Network/AboutDirection.html

问题81：在iDesktopX中处理管线数据时，发现某条线对象的长度为0，但其节点拥有X、Y坐标值，导致该数据在转为三维线时失败。

11.3.0
【问题原因】查看数据为平面无投影坐标系，量测实际长度为毫米级甚至纳米级，过小的线段长度被忽略为0了。
【解决办法】检查原始数据的单位，设置正确投影信息。

问题82：SuperMap iDesktop 12i版本是否支持将3dm格式的模型数据直接转换为S3M（SuperMap 3D Model）格式。

12.0.0
【解决办法】3dm格式不支持直接导入，支持直接导入的三维模型格式参考帮助文档：https://help.supermap.com/iDesktopX/zh/tutorial/DataProcessing/DataConversion/GeoFormates.html?rhsearch=%E6%95%B0%E6%8D%AE%E5%AF%BC%E5%85%A5%E5%AF%BC%E5%87%BA%E6%94%AF%E6%8C%81%E7%9A%84%E6%A0%BC%E5%BC%8F&rhhlterm=%E6%95%B0%E6%8D%AE%E5%AF%BC%E5%85%A5%E5%AF%BC%E5%87%BA%E6%94%AF%E6%8C%81%E7%9A%84%E6%A0%BC%E5%BC%8F

问题83：在iDesktopX 12.0.1版本中，无法对数据进行版本管理操作，咨询除了官方文档中提到的限制外，是否还有其他需要注意的事项。

12.0.0
【问题原因】数据源为postgis数据库型数据源，用户在数据库中使用命令创建数据集，导致在iDesktopX中数据集缺少sm字段，造成无法开启版本管理。
【解决办法】使用iDesktopX创建数据源后解决

问题84：在使用AI功能对遥感影像进行建筑物提取时，因本地计算机中安装了PostGIS环境，导致操作报错，出现环境冲突。

11.3.0
【问题原因】本地安装的PostGIS环境变量与超图桌面软件存在冲突，导致AI功能执行失败。 【解决办法】在操作系统的环境变量设置中，删除或暂时移除PostGIS相关的变量，然后重启iDesktopX软件即可。

问题85：咨询是否有提供SQL语句或脚本的方式来创建PostGIS类型的数据源，以替代在iDesktopX桌面端通过界面操作的创建方式。

11.3.0
【解决办法】超图产品目前不支持通过SQL语句或脚本的方式创建PostGIS数据源，必须通过iDesktopX桌面软件的界面功能或调用iObjects组件接口进行创建。

问题86：使用SuperMap iDesktopX制作镶嵌数据集后，在地图上进行浏览时，影像上出现了一些白色的噪点，咨询解决方法。

11.3.0
【问题原因】版本缺陷
【解决办法】更新双周包解决该问题，双周包地址：https://pan.baidu.com/s/1r4q55GpBItgLbP90LEg67g?pwd=6655#list/path=%2F

问题87：在iDesktopX中，如何将地理服务器标准的SLD（Styled Layer Descriptor）图层样式文件转换为超图平台支持的XML格式样式文件。

11.3.0

【问题原因】iDesktopX产品不直接兼容OGC标准的SLD文件，即使将后缀名改为xml也无法正确解析其样式内容。 【解决办法】需要手动在iDesktopX的图层风格设置中，参照SLD文件里定义的参数（如颜色、符号、渲染规则等），逐项进行配置以复现样式。

三、SuperMap iDesktop

问题1：在iDesktop 11.3版本中，使用“通过字段拆分数据集”功能拆分模型数据集时，操作总是提示失败。咨询该功能是否支持模型数据或有特殊要求。

11.3.0
【问题原因】用户使用的“拆分”功能不支持对模型数据集进行操作。 【解决办法】应使用工具箱中的“数据集按字段唯一值拆分”功能来根据字段拆分模型数据集。

问题2：咨询SuperMap iDesktop产品中，是否有类似ArcMap“空间连接”(Spatial Join)的功能，能够基于地理对象的空间关系（如相交、包含）来合并或传递属性信息。

11.3.0
【解决办法】可以使用iDesktop软件中【数据】选项卡下的【属性更新】功能来实现。该功能支持通过空间关系来匹配源数据集和目标数据集的要素，并进行属性字段的更新或追加。

问题3：咨询SuperMap Online官网示例中一个三维城市模型服务的具体制作方法，在仅有影像（DOM）和矢量边界数据的情况下，如何制作出类似的三维效果。

11.3.0
【解决办法】1. 访问SuperMap Online官网，在可视化范例中找到对应案例。2. 通过案例详情页的数据链接下载示例数据和详细的《数据制作手册》。3. 根据手册步骤进行操作。此外，官方示例中具有立体感的影像是通过Blender等三维软件渲染的，若无此条件，可直接使用地形和卫星影像生成三维场景。

问题4：用户在使用9D产品时，打开超图许可中心提示错误，导致无法正常读取加密狗许可。尝试以管理员身份运行、重装驱动均无效。

11.3.0
【问题原因】可能是许可驱动版本过旧或存在冲突导致。 【解决办法】使用cmd，命令卸载许可驱动，然后再用命令重新安装解决。

问题5：用户拥有1.7TB、2.2亿个S3M格式倾斜摄影切片文件，希望合并为一个大的SCP文件以方便管理。在尝试合并时，当生成的SCP文件达到400GB后软件发生崩溃。咨询此操作的可行性、性能影响及是否存在文件大小或数量的限制。

10.2.1
【问题原因】将海量（TB级别）的S3M零散切片合并为单个SCP文件，会受到桌面端软件处理能力、内存和操作系统文件大小（通常为2TB）的限制，导致处理过程中断或软件崩溃。 【解决办法】建议不进行合并操作。倾斜摄影数据推荐以S3M零散文件的方式进行存储和发布，直接加载图层的config文件即可正常使用。这种方式对加载和浏览性能更优，能有效避免单文件过大带来的各种问题。

问题6：在64位的SuperMap iDesktop 10.2.1中打开MDB格式的工作空间或数据源时，软件弹出错误提示：“数据源打开失败，‘Microsoft.ACE.OLEDB.12.0’ 提供程序未在本地计算机上注册”。

10.2.1
【问题原因】操作系统中缺少访问MDB数据库文件所需的64位Microsoft ACE OLEDB驱动程序。 【解决办法】下载并安装64位的“Microsoft Access Database Engine 2010 Redistributable”驱动程序（文件名为AccessDatabaseEngine_X64.exe）。安装完成后即可正常打开MDB数据源。下载链接：https://www.microsoft.com/en-us/download/details.aspx?id=13255

问题7：在iDesktop中导入无坐标系的FBX模型后，在场景中无法找到该模型，或模型在缩放时会消失。需要将模型正确定位并显示在场景中。

11.3.0
【问题原因】导入的模型自身Z值过大，导致位置过高悬浮在空中，缩放时超出可视范围。 【解决办法】1. 在【三维数据】-【模型工具】-【属性提取】功能中，提取模型的底部高程值。 2. 在场景图层管理器中，右键单击模型图层选择“风格设置”，在“位置”选项卡中，将底部高程设置为提取到的高程值的相反数（例如，提取值为5000，则设置为-5000），将模型贴近地表显示。

问题8：在iDesktop的属性表中，咨询如何使用表达式实现条件更新，即根据某一字段的值来更新另一字段的值。

11.3.0
【解决办法】在属性表中，首先使用“SQL查询”功能，通过SQL语句筛选出满足条件的目标记录。然后，在弹出的查询结果窗口中，使用“更新列”功能对所有筛选出的记录进行批量更新操作。

问题9：iDesktop桌面软件登录时失败，并提示许可被其他机器占用。

11.3.0
【问题原因】云许可已被其他设备登录占用。 【解决办法】登录超图在线许可管理中心（SuperMap Online），在许可管理页面找到当前被占用的许可记录，强制其退出，然后即可在本地iDesktop中重新登录使用。

问题10：iDesktop使用在线许可时提示“云许可获取失败”，检查发现本地网络连接正常。

11.3.0
【问题原因】云许可可能已被其他设备占用，导致新的登录请求失败。 【解决办法】登录超图在线许可管理网站（https://www.supermapol.com/），在账号管理中检查并强制退出其他已登录的设备，然后在iDesktop中重新登录即可。

问题11：使用iDesktop 12.0.0版本导入DWG格式数据后，CAD文件中的字体文本内容在地图上全部丢失，无法正常显示。

12.0.0
【解决办法】在地图窗口的图层管理器中右键点击地图，选择“属性”，在地图属性面板中，勾选“显示压盖对象”选项后，即可正常显示。

问题12：使用iDesktop对两个大数据集（面数据，分别为14G和91G）进行“合并数据集”操作时，任务长时间运行后失败，且日志中未记录明确的失败原因。

11.3.0
【问题原因】初步判断为数据库所在服务器的存储空间不足。在合并过程中生成临时文件或最终结果时，磁盘空间不满足要求导致操作失败。 【解决办法】清理数据库服务器的磁盘，确保有足够的可用的存储空间（建议大于待合并数据总量），然后重新执行合并操作。

问题13：在iDesktop中对数据集进行坐标系重设操作时，选择目标坐标系后，点击“应用”按钮无任何响应，也无法调出下方的坐标系信息。

11.3.0
【问题原因】桌面程序包可能存在文件损坏或环境异常。 【解决办法】将旧的iDesktop程序包完整删除后，重新解压一个新的程序包，问题得到解决。

问题14：在iDesktop中将多个SCP文件合并为一个嵌套SCP文件后，咨询如何在iDesktop中直接将其发布为三维服务。

11.3.0
【解决办法】在iDesktop桌面端无法直接发布服务，需要通过SuperMap iServer产品来加载工作空间或缓存文件，并将其发布为三维服务。

问题15：SKP模型文件在iDesktop中生成三维瓦片缓存时，出现桌面软件崩溃或长时间无响应的问题，导致缓存生成失败。

11.3.0
【问题原因】导入的SKP模型未进行实例化处理，导致生成瓦片时每个对象都需要单独处理，计算量巨大，非常耗时。 【解决办法】在iDesktop中导入SKP模型后，使用“三维数据-模型工具-实例化处理”功能对模型进行处理，然后再生成三维瓦片缓存即可。

问题16：使用iDesktop从数据库导入约400条记录的Excel数据时，导入过程界面长时间卡住且无响应。

11.3.0
【问题原因】直接导入Excel文件时可能存在兼容性或字段读取问题。 【解决办法】将Excel文件另存为CSV格式，然后通过iDesktop导入CSV文件即可成功。

问题17：在iDesktop中为三维场景图层配置“最大显示高度”后，关闭再重新打开，发现配置信息丢失，未被保存。

11.3.0
【问题原因】只保存了场景，未保存整个工作空间，导致场景属性的变更没有持久化。 【解决办法】在修改完场景属性后，需要同时保存场景和当前工作空间。

问题18：iDesktop中对三维场景图层配置的过滤高度信息，在对该场景生成三维瓦片缓存后丢失，导致前端显示效果不符合预期。

11.3.0
【问题原因】桌面版本比iServer版本高
【解决办法】iServer为10i版本，需通过10i版本iDesktopX进行数据处理

问题19：在三维场景中，加载的S3M模型被地形数据部分遮挡，需要对模型所在区域的地形进行编辑，降低地形高程以完整显示模型。用户尝试编辑UDB地形数据未成功。

11.3.0
【问题原因】地形镶嵌功能需要作用于TIN地形瓦片（缓存），而非直接作用于原始的UDB地形数据集。 【解决办法】1. 将原始栅格地形数据生成TIN地形缓存。 2. 在场景中加载TIN地形缓存。 3. 使用“三维地理设计”-“TIN地形操作”-“镶嵌”功能，绘制需要降低高程的区域即可完成地形修改。

问题20：对两种不同精度的DEM数据进行接边平滑处理时，在地形复杂区域（如山岭）或大范围数据处理时，结果中会出现凹陷和凸刺等异常情况。

11.3.0
【问题原因】操作不正确
【解决办法】使用客户提供数据验证没有问题，将验证过程与操作视频提供给客户，客户验证成功

问题21：在iDesktop中，如何对属性表中的数值型字段进行批量处理，以实现四舍五入并保留整数或指定位数的小数。

11.3.0
【解决办法】在iDesktop中打开属性表，右键点击目标字段的列头，选择“更新列”功能。在弹出的表达式输入框中，使用 Round([字段名], 小数位数) 函数对该字段进行运算即可。

问题22：基于倾斜摄影模型提取房屋高度时，房屋旁边的树木等非建筑地物会干扰高程点拾取，导致提取的高度值不准确。

11.3.0
【问题原因】“提取高度”功能是获取输入面范围内倾斜摄影模型的最低点和最高点高程。模型中的树木若被面范围覆盖，其高程也会被计入，从而影响建筑高度的准确性。 【解决办法】此为源数据处理问题，目前没有自动剔除干扰物的工具。需要在数据处理阶段，通过手动编辑房屋面数据的范围，精确地勾绘屋顶轮廓，以排除树木等干扰物的影响。

问题23：下载安装了SuperMap桌面产品后，尝试使用SuperMap Online账号登录以获取试用许可时失败，咨询当前版本是否支持该方式试用。

11.3.0
【问题原因】Online试用许可可能已被占用、与产品版本不匹配或已过期。 【解决办法】登录SuperMap Online官网（https://www.supermapol.com/），进入个人中心检查许可状态、版本信息以及当前是否处于被占用的状态。

问题24：使用iDesktop进行三维管线建模时，网络拓扑图层生成的自适应管点显示正常，但在制作专题图并关联图层风格后，自适应管点无法正确连接，出现断开现象。

12.0.0
【问题原因】符号库中的三维自适应管点符号参数被修改，导致其无法按预期进行自适应连接。 【解决办法】在符号编辑器中打开对应的三维自适应管点符号，将其参数恢复为默认值，保存后重新打开场景即可。

问题25：用户在使用iDesktop进行三维管线建模时，通过“建立三维网络”功能并使用自适应管点符号后，管线会失去原有的埋深信息，呈现为贴地状态。用户希望在体现管线埋深和管径的同时，也能正确生成匹配的弯头三通等管件。

11.3.0
【问题原因】建立三维网络后，管线图层的风格设置不正确，导致高程信息未能正确表达，使管线看起来是平的。 【解决办法】检查并调整三维网络管线图层的图层风格设置，确保其高度模式和相关参数正确配置，即可恢复管线的埋深显示。

问题26：如何在三维场景中，让三维管线模型根据管径字段属性值的大小进行不同程度的缩放显示？

11.3.0
【问题原因】制作专题图时，用于控制缩放的管径字段非数值类型，导致无法选择。此外，网络数据集中的字段类型无法直接修改。 【解决办法】1. 使用自定义专题图功能，在线型风格中选择一个数值型字段（如整型或双精度）作为缩放大小的依据。 2. 若原管径字段为文本等非数值类型，需新建一个数值型字段，然后通过“更新列”功能将原字段的值转换后复制到新字段中，再使用该新字段进行专题图设置。

问题27：在iDesktop中进行数据处理时，如构建网络数据集，如何设置才能在指定路径下生成结果，而不产生带后缀的备份文件？

11.3.0
【解决办法】在功能操作面板的下方，找到并取消勾选“保留备份文件”选项即可。

问题28：使用自定义专题图按管径（单位mm）缩放管线时，模型在三维场景中显示比例过大，应如何调整？

11.3.0
【问题原因】符号库中符号尺寸单位为毫米（mm），而自定义专题图的线型宽度单位为米（m），单位不一致导致比例问题。 【解决办法】新建一个字段，通过“更新列”功能将原管径字段的毫米单位数值除以1000，转换为米单位，然后使用这个新字段来设置专题图的缩放。

问题29：数据中存在坐标完全相同的重复点，是否会影响三维网络数据集的构建？应如何处理这些重复点？

11.3.0
【问题原因】重复点会影响网络数据集的拓扑关系正确性。 【解决办法】1. 将三维点数据转换为二维点数据集。 2. 使用“拓扑检查”功能，规则选择“点重复”，对二维点数据集进行检查，并勾选“修复拓扑错误”以自动删除重复点。 3. 将处理后的无重复点的二维数据集重新转换为三维点数据集使用。

问题30：使用拓扑检查功能并勾选“修复拓扑错误”后，数据集中的重复点并未被删除，是什么原因？

11.3.0
【问题原因】待检查的数据集可能与CAD数据集等其他数据存在关联关系，导致无法直接修改。 【解决办法】在执行拓扑检查前，先在工作空间管理器中将关联的CAD数据集移除，解除其与点数据集的关联关系，然后再执行拓扑检查和修复操作。

问题31：SuperMap iDesktop中的场景文件（.scnx）与数据源（.udb/.udd）是什么关系？如果删除了数据源，场景是否还能查看？

11.3.0
【问题原因】场景文件中存储的图层是对数据源中数据集的引用，而非数据实体。 【解决办法】场景文件本身不保存地理数据，它依赖于原始数据源。如果对应的数据源或数据集被删除，场景中对应的图层将无法显示数据。

问题32：如何将Revit的RVT格式族文件转换为SuperMap iDesktop中符号库可识别和使用的三维模型符号？

11.3.0
【问题原因】SuperMap iDesktop不直接支持导入RVT格式作为三维符号。 【解决办法】1. (推荐流程) 在Revit中将模型导出为FBX等通用三维格式。 2. 将导出的FBX模型导入到3ds Max中进行编辑和检查。 3. 在3ds Max中安装并使用SuperMap插件，将模型导出为SGM格式。 4. 在iDesktop的符号库编辑器中，导入SGM模型文件作为三维点符号。新版本iDesktop也支持直接导入FBX等格式。

问题33：从Revit导出的FBX模型导入到iDesktop符号库并应用后，模型在场景中出现了位置偏移，如何解决？

11.3.0
【问题原因】符号在场景中的位置是基于其模型自身的原点（坐标轴心）与数据点的坐标对齐的。如果模型几何实体偏离了其原点，就会导致显示偏移。 【解决办法】在原始建模软件（如Revit或3ds Max）中，将模型的坐标轴心（或项目基点）移动到模型的正确位置（通常是底部中心），然后再重新导出模型。

问题34：将FBX模型导入iDesktop符号库后，模型的材质丢失了，应如何处理？

11.3.0
【问题原因】材质丢失通常是由于导出FBX时材质信息或贴图路径未正确嵌入或关联。 【解决办法】建议先将FBX模型导入到3ds Max等专业三维软件中进行检查，确保材质和贴图路径均正确无误，然后再从3ds Max中重新导出为FBX或通过SuperMap插件导出为SGM格式，以确保材质信息完整。

问题35：如何将点数据集中每个点的属性，根据空间位置关系，赋给其所在的对应面数据集中的面对象？

11.3.0
【解决办法】使用“数据处理”-“属性更新”功能。源数据集选择点数据集，目标数据集选择面数据集，工具会基于“包含”的空间关系，将点的属性更新到其所在的面对象上。

问题36：在iDesktop中连接达梦数据库时，数据源类型选项为灰色不可用状态。这通常是由于缺少数据库客户端所需的依赖文件（如dmoci.dll）导致的，希望能提供缺失的依赖文件。

11.3.0
【问题原因】iDesktop安装目录下缺少连接达梦数据库所需的客户端依赖库文件。 【解决办法】将达梦数据库客户端依赖库（如dmoci.dll等文件）拷贝到iDesktop安装目录下的bin文件夹中，然后重启iDesktop即可正常连接。

问题37：咨询iDesktop桌面端的点云实例分割功能，分割结果是什么类型的？

11.3.0
【解决办法】分割后的结果还是点云数据，分割结束后，将得到电力场景点云的电力线、杆塔等实例个体，属于同一实例的点具有相同实例ID，记录在结果文件的InstanceID属性字段中。

四、SuperMap iClient3D for WebGL

问题1：咨询iClient三维在国产显卡（如摩尔线程S50）上性能不佳、加载缓慢的问题。用户反馈加载三维球服务需要很长时间，并询问网络请求阻塞的优化方案。

11.3.0
【问题原因】1. 国产硬件性能存在瓶颈。2. 浏览器对同域名的并发请求数量有限制，导致资源加载阻塞。 【解决办法】1. 升级至12i版本，初始化Viewer时设置performancePreferenceMode为性能优先。2. 通过Nginx配置多子域解决浏览器并发请求限制，参考：https://blog.csdn.net/supermapsupport/article/details/126406459。3. 优化前端首屏加载，将非必要资源后置加载。

问题2：在本地部署的iClient应用中，请求官网的在线服务（如CBD模型）时出现跨域问题，导致数据加载失败，即使浏览器设置了允许跨域也无效。

11.3.0
【问题原因】超图官网在线服务（supermapol.com）启用了HTTPS，而示例代码中部分服务地址仍为HTTP，导致协议不一致请求失败。 【解决办法】在iClient示例的config.js等配置文件中，将所有http://www.supermapol.com的服务地址修改为https://www.supermapol.com。

问题3：咨询超图 Web 端三维产品（WebGL）是否支持在场景中进行等高线分析和坡度分析，并进行可视化显示。

11.3.0
【解决办法】产品支持该功能。可通过参考官方示例代码实现坡度坡向分析和等高线分析。坡度分析示例链接：http://support.supermap.com.cn:8090/webgl/examples/webgl/editor.html#terrainSlopeAnalysis

问题4：使用iClient3D for WebGL加载国家天地图的经纬度坐标系（CGCS2000）WMTS服务时，影像图层无法在三维球上正确渲染，显示异常，出现瓦片错乱或撕裂现象。

11.3.0
【问题原因】加载非标准墨卡托投影的WMTS服务（如天地图CGCS2000服务）时，未在WebMapTileServiceImageryProvider中提供与该服务匹配的 tilingScheme（切片方案）详细参数。 【解决办法】需要根据WMTS服务的GetCapabilities文档，在代码中显式构造一个SuperMap3D.GeographicTilingScheme对象，并正确填充numberOfLevelZeroTilesX、ellipsoid、scaleDenominators、origin等参数，确保与服务定义完全一致。可参考博客：https://blog.csdn.net/supermapsupport/article/details/147294870

问题5：矢量瓦片服务在三维场景中加载时，部分图层（如hillshade类型）的样式和符号丢失，导致显示异常。定位为iClient3D for WebGL不支持加载包含hillshade类型的矢量切片服务，导致解析失败。

11.3.0
【问题原因】客户的矢量切片服务中存在iClient3D for WebGL不支持的 hillshade 类型图层，导致加载异常。 【解决办法】1. 项目上已编写代码跳过不支持的图层，使矢量图层成功加载。 2. 产品层面将进行优化，自动跳过不支持的图层。 3. hillshade图层效果（地形晕渲）可通过iDesktopX结合地形数据生成地图瓦片来替代实现。

问题6：经过版本升级和工具处理后的三维模型切片，在Web前端加载时，模型整体颜色偏黑，效果远不如在iDesktopX桌面端中明亮。

11.3.0
【问题原因】模型使用了PBR（Physically-Based Rendering）材质，其显示效果强依赖于光照环境。桌面软件和Web前端的光照设置不同，导致渲染效果差异。 【解决办法】在前端应用中进行调整：1. 调整三维场景的时间轴，改变太阳光照角度。2. 通过代码调整S3M图层的渲染参数，如亮度（brightness）、对比度（contrast）等，以优化显示效果。

问题7：在WebGL三维场景中，如何让带有高程信息的S3M模型图层在无地形数据的情况下，能够自动贴着地面展示，而不是悬浮在空中。希望能通过API实现，避免为每个模型手动拾取高程并硬编码。

11.3.0
【问题原因】S3M模型本身带有绝对高程信息，在没有地形的场景中加载时，会根据其原始高程值显示在对应高度，导致视觉上悬浮。 【解决办法】通过设置S3M图层的bottomAltitude（底部高程）属性为模型底部高程的负值，可以实现模型整体下移至贴地（高度为0）的效果。对于批量不同高程的模型，需在加载时动态获取每个模型的底部高程值，然后将该值的负数赋给bottomAltitude属性。

问题8：在WebGL三维场景中，如何设置S3M模型中某个构件（如隧道洞身）为半透明。

11.3.0
【解决办法】使用layer.setObjsColor([ids],SuperMap3D.Color.WHITE.withAlpha(0.5))，设置单个或多个图元的透明度。

问题9：咨询如何在三维倾斜摄影数据上叠加视频，并实现融合展示的技术方案或示例。

11.3.0
【解决办法】查看技术博客文章和在线示例代码，用于实现在倾斜摄影模型上叠加视频（如RTSP流）的效果。 博客链接: https://blog.csdn.net/supermapsupport/article/details/94328485 示例链接: http://support.supermap.com.cn:8090/webgl/examples/webgl/editor.html#RTSP

问题10：访问官网的iClient3D for WebGL动态标绘示例时，页面报错，疑似存在跨域问题，导致示例无法正常运行。

11.3.0
【问题原因】官网示例页面链接的服务地址存在跨域问题。 【解决办法】暂时使用备用链接（https://www.supermapol.com/webgl/examples/webgl/editor.html#plot_dynamicPlot）进行访问。后续官网链接将进行修复更新。

问题11：使用iClient3D for WebGL或原生Cesium加载iServer发布的三维瓦片服务时，若服务URL中包含“+”字符，前端库在部分版本（如11.2.1）下无法自动将其转义为“%2B”，导致LOD瓦片请求失败，模型加载不出来。

11.2.1
【问题原因】前端库在旧版本中未对URL中的“+”等特殊字符进行强制转义处理，导致服务端无法正确解析请求地址。 【解决办法】 1. SuperMap iClient3D for WebGL场景：升级至11.3.0及以上版本，并在加载服务时设置isSuperMapiServer:true参数，即可自动处理转义。 2. 原生Cesium场景：通过自定义Cesium.Proxy代理，在URL发送前使用replaceAll(‘+’, ‘%2B’)方法替换“+”字符。

问题12：用户在前端实现管线流动效果时，询问如何保证流动的方向是正确的。用户发现没有直接设置管线流向字段的参数，希望能控制特定管线的流动方向。

11.3.0
【问题原因】前端管线流动是模拟效果，其流动方向并非由属性字段直接控制。 【解决办法】前端管线的流动方向取决于两个因素：1. 管线线对象的绘制方向（起点到终点）；2. 图层的 textureUVSpeed 属性（可设置正负值控制方向）。通过调整这两个数据可以确定具体管线的流动方向。

问题13：用户反馈同一个矢量瓦片服务，在前端Vue项目的不同路由下加载，style.json的加载时间有差异，且最终地图渲染完成时间相差7-8秒，寻求问题原因。

11.3.0
【问题原因】客户的显卡性能很低,约等于GTX450，而两处设置的渲染分辨率不一致,设置高分辨率的数据加载会导致gpu瞬间沾满卡住一段时间.
【解决办法】初始化场景的contextOptions参数和加载MVT的canvasWidth参数设置相同参数.

问题14：在企业微信内置浏览器中加载二维地图应用时，控制台报错 “RangeError: Array buffer allocation failed”。此问题在标准的谷歌浏览器中不存在。

11.3.0
【问题原因】该问题发生在特定浏览器（企业微信内置浏览器）中，报错信息指示内存缓冲区分配失败。这通常是由于浏览器内核版本过低或其对WebGL内存管理的支持不佳导致的，属于浏览器环境兼容性问题。 【解决办法】建议用户更换为产品官方支持的现代浏览器（如较新版本的Chrome）来访问应用。

问题15：在一台国产终端机上，三维球加载图层时性能很差，非常缓慢。希望寻求技术支持，最好能现场解决。

11.3.0
【问题原因】经排查，该终端机的显卡型号为AMD Radeon HD 8570，是一款2013年发布的旧型号显卡，其性能严重不足，无法满足流畅运行三维GIS应用的需求。 【解决办法】此问题为硬件性能瓶颈导致，软件层面无法优化解决。建议升级或更换具有更高性能独立显卡的硬件设备。

问题16：咨询iClient3D for WebGL产品是否提供测量角度的功能或相关接口。

11.3.0
【解决办法】当前版本的iClient3D for WebGL产品中，没有内置直接测量角度的接口或量算工具。

问题17：在iServer 11版本中发布三维场景服务，前端使用配套的Cesium库加载时，场景中出现白色图块的渲染异常问题。即便将前端Cesium包升级到与iServer版本一致，问题依旧存在。

11.3.0
【问题原因】前端场景的透明排序参数（scene.orderIndependentTranslucency）开启后，与当前场景或系统环境存在冲突，导致渲染出现异常白块。 【解决办法】在前端代码中，将场景的透明排序参数设置为false，关闭该功能后，场景显示恢复正常。

问题18：在Web三维场景中，希望能实时交互式绘制三维管线。通过选择两个管点，并指定埋深和管径来生成三维管线实体。但在实际操作中，无法精确获取空间点的Z值（高程），导致管线始终贴地，无法控制其在空间中的高度。

11.3.0

【问题原因】在三维场景中默认拾取的是地表坐标，无法直接获取空间点的高程；同时，将管线绘制到地下后，默认会被地形遮挡而不可见。 【解决办法】1. 开启场景的地下模式，设置地球透明度，使得地下物体可见。参考代码：viewer.scene.globe.translucency.enabled = true;。 2. 参考官方“绘制与编辑”示例，通过鼠标左键上下移动来调整线节点的Z值（高程），实现管线在空间中的精确定位。3. 可结合地形开挖功能，在管线周围进行开挖，以便更清晰地观察地下管线。

问题19：使用iClient3D for WebGL产品时，在分屏模式下，对其中一个分屏窗口进行地图缩放或拖动操作时，地图的响应存在偏移，操作中心未精确跟随鼠标当前位置，影响交互体验。

11.3.0
【问题原因】产品在分屏模式下，对部分分屏视图中的鼠标事件（缩放、拖动）坐标计算存在缺陷，导致操作偏移。 【解决办法】该问题已在iClient3D for WebGL 11.3.0的内部修复版本中解决。请下载并升级至提供的修复包（supermap-iclient3d-for-webgl_webgpu-11.3.0-260202-49502.zip）即可。

问题20：咨询在三维场景中对地质体模型进行剖面分析后，是否能获取剖面上关键点的三维坐标，或将整个剖切面导出为二维数据。

11.3.0
【问题原因】前端（WebGL客户端）没有直接提供导出剖面或获取剖面关键点坐标的接口。 【解决办法】可通过后端实现，使用iObjects Java组件或iServer的GPA服务，通过“提取数据”功能，使用一组指定的XY二维点，依次提取地质体模型上对应点的高度，从而获得一系列三维点坐标来重构剖面线。

问题21：项目中集成了两个并存的Vue页面，分别使用SuperMap iClient for WebGL和原生Cesium。当从一个页面切换到另一个页面时，后加载的页面无法正常显示点位，并报"scene未定义"的错误。

11.3.0
【问题原因】初步判断是由于两个系统在同一个Vue页面环境中切换时，存在全局变量或场景（scene）对象的命名冲突或销毁不当，导致后加载的系统无法获取到有效的scene定义。 【解决办法】项目开发人员修改代码逻辑解决

问题22：针对iClient3D for WebGL的性能优化，用户对初始化Viewer时是否需要显式设置 performancePreferenceMode 参数有疑问，认为默认值可能已是性能优先。

11.3.0
【问题原因】用户对performancePreferenceMode参数的默认行为和最佳实践存在疑问。 【解决办法】技术支持明确指出，为确保性能优先模式被正确应用，建议在初始化Viewer时显式设置该参数：performancePreferenceMode = SuperMap3D.PerformancePreferenceMode.Performance。

问题23：使用代理服务访问iServer三维S3M服务，前端客户端因无法通过代理地址正常请求到login.json和license.json进行鉴权和许可验证，导致三维场景加载失败。

12.0.0
【问题原因】旧版前端三维客户端加载服务时，会请求服务动态路径下的login.json进行验证
【解决办法】1、建议将前端三维客户端（iClient for Cesium或iClient3D for WebGL）升级至12.0.0（即2025版）及以上版本。
2、在nginx代理中，增加对login.json文件地址的强制访问

问题24：咨询将WebGIS项目代码从超图的iClient for Cesium产品线迁移到iClient3D for WebGL产品线时，相关的API接口是否有简明的替换规律或升级说明。

11.3.0
【解决办法】API迁移具有非常明确的规律。在项目代码中，进行全局替换，将原有的全局对象 Cesium 替换为 SuperMap3D 即可完成绝大部分API的升级迁移。

问题25：用户咨询关于需求DPL-362的实现方式，即如何在 iClient3D for WebGL 中加载 iServer 发布的 rest 地图服务时，控制服务中各个子图层的显示顺序和可见性，并确认所需的产品版本。

11.3.0
【解决办法】通过 SuperMapImageryProvider 对象的 setLayerStatusParameters 接口即可实现。传入一个包含 layerName 和 isVisible 属性的图层对象数组，数组中元素的顺序即为子图层在场景中从上到下的显示顺序。此功能在12.0.1版本中测试正常，无需更新现有产品包。

问题26：用户在使用setLayerStatusParameters接口时遇到新问题，该接口只能调整单个地图服务（Provider）内部的子图层顺序。用户需要在在线制图场景下，实现跨越多个不同地图服务（Provider）的子图层顺序调整。

11.3.0
【问题原因】iClient3D for WebGL 中，影像图层Provider的渲染优先级高于其内部子图层的优先级，因此无法直接跨Provider设置子图层顺序。 【解决办法】将需要进行顺序交叉的同一个服务URL，根据需要显示的子图层，拆分成多个独立的SuperMapImageryProvider实例。然后通过调整这些Provider实例本身的叠放顺序，来间接实现跨服务的子图层顺序调整。

问题27：在iClient3D for WebGL/WebGPU 12.0.1版本中，将地图服务贴到倾斜摄影模型上可以成功，但尝试将MVT矢量瓦片服务贴到模型上时却无法显示。

12.0.0

【解决办法】在iClient3D for WebGL中，若要实现矢量瓦片（MVT）服务贴在倾斜摄影模型上的效果，需要调用 S3MLayer.coveredMap接口进行添加和设置

五、SuperMap iManager

问题1：生产环境的iManager无法访问，所有通过其部署的GIS服务也都已中断。需要排查原因并恢复服务。

11.3.0
【问题原因】iManager所在的Kubernetes集群中，某一节点的根目录磁盘使用率超过80%，触发了Pod驱逐机制，导致iManager等服务容器被停止。 【解决办法】清理集群节点（特别是磁盘占用高的节点）的根目录磁盘空间，确保使用率低于80%，以便Kubernetes能正常调度运行Pod。

问题2：iManager管理的k8s环境中所有GIS服务节点全部宕机，无法提供服务。

11.3.0
【问题原因】Kubernetes集群中服务Pod的镜像拉取策略（ImagePullPolicy）配置不当，导致节点重启后无法正常拉取镜像并启动。 【解决办法】修改服务部署的YAML配置文件，将镜像拉取策略调整为正确的值（如IfNotPresent或Always），使节点可以正常拉取镜像并恢复服务。

问题3：在iManager环境中修改了某个GIS应用(gisapp)的配置后，如何使配置生效。用户希望避免重启整个节点，因为重启会引起2-3分钟的服务中断。

11.3.0
【解决办法】1. 在iManager站点的“应用”管理页面，找到对应的gisapp，点击“编辑”修改配置并提交，此时gisapp会自动进行滚动更新（重启）。2. 随后，找到iServer-gateway应用，对其执行“重新部署”操作，使其加载新的路由配置。此流程无需重启物理节点，影响范围更小。

问题4：升级后的三维模型，通过独立iServer发布能正常显示，但通过云套件发布后，前端无法加载出三维模型。在iManager中预览正常。

11.3.0
【问题原因】项目升级了前端WebGL库版本，新版库在加载三维服务时需要请求license.json接口进行许可验证。但部署的云套件版本较旧，其服务代理相关组件缺少此接口，导致前端请求失败。 【解决办法】升级云套件中与服务代理和仪表盘相关的三个镜像：iserver-servicelist、common-dashboard-ui 和 common-dashboard-api 至指定的新版本。

问题5：咨询iManager平台是否支持将terrainrgb格式的地形数据发布为WMTS（Web Map Tile Service）服务。

11.3.0
【解决办法】支持。在iManager上发布terrainrgb格式数据为WMTS服务的操作流程与在独立的iServer中完全相同。

问题6：咨询在iManager上发布terrainrgb的WMTS服务时，是否需要修改配置文件，并提到之前在iManager上修改未成功，最后在iServer上修改才成功。

11.3.0
【解决办法】发布terrainrgb数据为WMTS服务时，无论是在iServer还是iManager环境中，都无需手动修改任何配置文件。直接在发布向导中选择发布为WMTS 1.0.0版本即可正常使用。

问题7：咨询在iManager管理页面上，对于当前未在使用的iPortal等服务实例，是否可以停止以节约资源。

11.3.0
【解决办法】可以在iManager的服务管理界面，找到不需要的服务实例，点击其对应的“停用”按钮即可。后续需要时可以再启用。

问题8：咨询部署iManager的Agent Server时，服务器操作系统是否必须是欧拉或麒麟系统，或者两者都可以。

11.3.0
【解决办法】部署Agent Server的服务器操作系统只需要是Linux(x64)即可，帮助文档中提到的欧拉或麒麟系统仅为举例推荐。

问题9：部署在Kubernetes环境的超图云套件，在iManager页面上无法看到已发布的所有GIS服务，服务列表为空。

11.3.0
【问题原因】云套件内置的PostgreSQL数据库中用于记录服务实例的instances表数据损坏，导致服务列表无法正常加载。 【解决办法】1. 连接到云套件的PostgreSQL数据库，删除损坏的instances表，并使用提供的SQL语句重建表结构。2. 执行云套件的备份恢复功能，从最近的有效备份中恢复服务数据。

问题10：在一套新的云套件环境中，使用之前修复好的服务备份文件进行恢复操作，恢复流程长时间卡在40%，无法完成。

11.3.0
【问题原因】云套件中的consul服务状态异常，导致备份恢复流程中断。 【解决办法】通过kubectl或类似工具，删除并重建云套件中所有的consul-* pod。待consul服务正常启动后，重新执行备份恢复操作。

问题11：咨询超图产品体系中，是否有类似iManager但能以组件形式提供，用于监控算法服务和模型服务的运行状态。

11.3.0
【解决办法】目前没有以组件形式提供此类监控功能的产品。SuperMap iManager产品可以实现对GIS服务的监控，但它是基于Docker容器化环境部署的独立运维管理平台，而非组件。

问题12：iManager部署的iServer站点，通过Nginx反向代理后，访问前端页面显示不正常。浏览器控制台报错，提示部分静态资源文件（如CSS、JS）找不到（404错误）。

11.3.0

【问题原因】Nginx作为反向代理服务器时，若配置不当，会导致前端页面引用的静态资源路径解析错误，从而无法正确加载。 【解决办法】需要参考官方推荐的Nginx配置方案进行正确配置。具体配置方法详见官方博客链接：https://blog.csdn.net/supermapsupport/article/details/127074609

问题13：用户为国土专网、互联网天地图、政务外网天地图、智慧黑河等多个项目申请软件许可，涉及iManager 11i和iPortal 10.0产品，并提供了服务器机器名。

11.3.0
【解决办法】根据用户提供的多台服务器的机器名，为其生成了对应的iManager 11i和iPortal 10.0的软件许可文件，并通过私聊方式发送给了用户。

问题14：安装iManager时部署界面进度条卡住不动。经排查，是由于K8S集群中的deployment-center Pod内部无法解析value.yaml文件中为masterurl配置的域名所致。

11.3.0
【问题原因】iManager的deployment-center Pod内部无法解析value.yaml中masterurl配置的域名，导致部署流程中断。 【解决办法】将value.yaml文件中的masterurl参数值由域名修改为IP地址后，重新执行部署安装。

问题15：用户在重新安装云套件时，询问是否可以直接指定一个已存有数据的NFS目录，以避免重新迁移大量数据。

11.3.0
【问题原因】SuperMap云原生GIS套件在部署时会自行创建和管理存储目录结构，不支持直接挂载一个结构不匹配的现有数据目录。 【解决办法】需在云套件部署完成后，将原有数据手动迁移到系统自动生成的新目录结构中。

问题16：在GIS平台的文件夹管理功能中，无法上传数据或新建文件夹，操作后提示上传失败。经排查，在非根目录下可以正常操作。

11.3.0
【问题原因】用户尝试在根目录（/）下进行文件操作，但系统设计上，根目录无法通过Web界面进行权限分配，导致用户没有操作权限。 【解决办法】建议用户不要直接在根目录上传文件，应在根目录下新建一个专用文件夹，并为该文件夹分配合适的权限，再进行数据上传和管理。

问题17：为GIS平台更换新的SSL证书后，网关出现问题，导致所有服务无法访问。排查发现更换证书后相关Pod未正常重启，且Kubernetes的master节点服务器卡死，无法通过命令重启。

11.3.0
【问题原因】更换SSL证书后，Kubernetes集群的master节点底层调度出现问题，未能成功重启相关服务Pod以应用新证书，最终导致master节点服务器宕机。 【解决办法】联系运维人员对核心区的master节点服务器进行物理重启。服务器重启后，各服务Pod恢复正常，平台访问恢复。

问题18：使用iManager配套的Kibana工具导出服务访问日志时，由于日志数据量过大，导致导出过程非常缓慢或直接失败，无法获取全量数据来统计服务访问总量和超时占比。

11.3.0
【问题原因】承载日志服务的Elasticsearch容器资源分配不足（2核2G），无法应对大量数据的查询和导出请求。 【解决办法】1. 将Elasticsearch容器的资源规格从2核2G提升至4核8G。 2. 在Kibana中调整超时时间的判定阈值，按需分别统计。 3. 调整配置后成功导出全量数据到Excel进行汇总分析。

问题19：咨询两套部署在不同环境的iManager for k8s，是否可以配置使用同一套共享文件目录和数据库，以避免数据冗余存储。

11.3.0
【解决办法】这个需要修改任意一个环境的pv使其nfs的持久化目录与另一个相同,pv里面的不能直接做修改。j具体操作步骤如下：
1、导出 pvc 和 pv 成yaml文件
2、删除 pvc 和 pv
3、修改导出yaml中 pv 中 nfs 路径
4、apply 修改 pv 和 pvc（如果状态不对，还行修改pv中pvc的id等信息）
5、删除重建与pv相关的容器，如：gisapp-*、dashbord-api 、iserver-servicelist、file-manager…

六、SuperMap iPortal

问题1：iPortal无法检测到由iServer高级版许可提供的Web许可。之前可以正常读取，但在重新生成reportc文件后出现问题，重启服务、删除许可配置节点等操作均无效。

11.3.0
【解决办法】使用当前新生成的reportc文件，重新申请正式的 iPortal 许可文件，然后登录 Web 许可中心，在“激活更新”页面中上传并导入该新许可文件。注意：在 iPortal 的许可管理页面，确保填写的 Web 许可地址格式正确（ws://172.16.4.69:9183），然后重新连接或刷新许可状态。

问题2：用户反馈其iPortal升级至11.3.0版本后，依然无法新建密钥。尽管前端能读取到serverid，但创建操作最终失败。

11.3.0
【问题原因】是人大金仓的配置问题，数据库的ora_input_emptystr_isnull默认是on
【解决办法】对KingbaseES的数据库修改全局变量：ALTER DATABASE a_iportal set ora_input_emptystr_isnull=off;
查看设置是否生效：show ora_input_emptystr_isnull;
然后重启KingbaseES，这样iPortal在keycodes表添加行就不会报错

问题3：咨询iServer和iPortal是否支持对接外部统一用户权限系统（如OA系统），实现用户信息的同步、统一登录，并能在超图平台内对这些同步过来的用户进行模块和数据的权限配置。

11.3.0
【解决办法】可以通过调用iPortal提供的用户管理REST API接口，实现与外部用户系统的对接。外部系统可读取自身用户信息，然后调用iPortal接口来批量创建或同步用户，之后在iPortal中为这些用户或其所属角色分配GIS资源访问权限。

问题4：iPortal连接人大金仓数据库时，在服务管理-密钥管理页面无法新建密钥，即使尝试将数据库keycodes字段设置为允许为空也无效。

11.3.0
【问题原因】使用的人大金仓（KingbaseES）数据库，其配置项ora_input_emptystr_isnull默认为on，导致iPortal在向keycodes表插入空字符串时被当作NULL处理，与表结构约束冲突而报错。 【解决办法】修改人大金仓数据库的全局变量，将空字符串和NULL值进行区分。执行SQL命令 ALTER DATABASE a_iportal set ora_input_emptystr_isnull=off; 并重启数据库服务。

问题5：咨询iPortal大屏下钻组件的可用性，并根据支持建议升级iPortal版本及申请新版许可。

12.0.0
【问题原因】当前iPortal版本的大屏不支持下钻组件功能。 【解决办法】1. 更换为支持下钻组件的新版iPortal安装包进行升级。 2. 申请并配置与新版本匹配的试用许可文件。

问题6：iPortal升级后，在大屏中添加的底图无法正常加载显示，而地图服务本身可以访问。

12.0.0
【问题原因】地图未设置最大可见比例尺，导致在大屏组件中默认缩放级别下不显示。 【解决办法】登录iPortal，在“数据上图”中编辑该地图，将其最大可见比例尺设置为16级后保存即可。

问题7：如何根据不同用户和其所在的地理区域，动态控制地图瓦片的显示层级？例如，用户A在哈尔滨区域可以看0-21级瓦片，但在其他区域只能看0-18级。

11.3.0
【问题原因】需求分为两部分：1.按空间范围控制访问；2.在不同空间范围下控制不同的显示层级。其中第2点产品暂不支持。 【解决办法】对于按空间范围控制访问的需求，有两种方案：1. 在前端通过代码监听地图事件，结合用户权限判断当前范围是否可见，控制图层显隐。2. 使用iPortal产品的服务代理和权限控制功能，为不同用户设置基于空间范围的访问权限。

问题8：在Linux服务器上启动iPortal服务失败，无法正常运行。

11.3.0
【问题原因】在Linux操作系统中，出于安全策略，iPortal服务不被允许使用root账户进行启动。 【解决办法】切换至一个非root权限的普通用户，然后使用该用户身份重新执行iPortal的启动脚本。

问题9：在iPortal或iServer Manager等Web管理页面中，点击地图资源时，页面不跳转，而是在浏览器右上角提示下载文件。

11.3.0
【解决办法】这可能是浏览器或前端页面的行为，直接复制提示的链接地址，在浏览器新标签页中打开即可访问。

问题10：iPortal许可配置更新问题，用户在重新生成reportc文件后，需要更新对应的正式许可。

11.3.0
【解决办法】使用新生成的reportc文件重新申请正式的iPortal许可文件。然后登录Web许可中心，在“激活更新”页面上传并导入新许可。同时，在iPortal的许可管理页面，确保Web许可地址格式正确（如 ws://IP:PORT）。

问题11：针对iPortal地图大屏提出功能需求：地图全幅显示；

12.0.1
【解决办法】在地图大屏中将地图组件放入容器组件，并开启其中的全屏按钮。

问题12：内网环境部署的iPortal对接单点登录后，出现登录不稳定的问题，时而能成功登录，时而报错，无法稳定使用。

11.3.0
【问题原因】客户环境中的casdoor存在不稳定情况，导致iPortal登录不稳定
【解决办法】后续产品可以优化iPortal的兼容能力，抛出正常的错误

问题13：咨询iPortal 10i、iServer、iManager从现有环境迁移至华为统信ARM服务器的可行性，并需要获取适配ARM架构的安装包及相应许可。

10.2.1
【问题原因】用户需要在ARM架构的华为统信服务器上部署超图云GIS产品，需要使用专门适配ARM架构的软件版本。 【解决办法】提供了iPortal 10.2.1、iServer 11.3.0及iManager 11.3.0的ARM版本安装包下载链接，并根据用户提供的机器信息生成了相应的许可文件。

问题14：iPortal中，通过服务注册功能将服务注册并管理后，在资源中心页面中无法看到已注册的服务，导致服务无法正常使用。

11.3.0
【问题原因】iPortal底层的Elasticsearch索引没有及时更新，导致新注册的服务资源无法被检索到。 【解决办法】通过修改iPortal配置文件重建索引。具体步骤为：将iPortal安装目录下iPortal.xml文件中的标签值设置为true，然后重启iPortal服务即可。

问题15：将高斯泼溅数据发布为三维服务后，在iPortal门户中加载该服务时显示黑屏，无法正常渲染和浏览。

11.3.0
【问题原因】iPortal的三维地球里面引入的WebGL版本低
【解决办法】1.在iPortal目录\webapps\iportal\WEB-INF\lib找到webjar-earth-v2-*.jar 用解压工具直接打开
2.替换\META-INF\resources\apps\earth\v2\SuperMap3D下面的内容为可用的WebGL的包

问题16：iPortal制作的大屏，共享设置为“任何人可见”后，分享出去的链接中柱状图、表格等组件的数据无法显示。

11.3.0
【问题原因】客户的图表组件所用资源的共享方式与该地图大屏不同，导致无法在共享后的大屏中正常展示
【解决办法】修改地图大屏中的数据共享方式，改为“公开下载”即可。

七、SuperMap iObjects Java

问题1：使用 OverlayAnalyst.union 接口对多个数据集进行合并操作时，在不同电脑上性能差异巨大。部分电脑只需4分钟即可完成，而部分电脑运行十几分钟仍未完成。

12.0.0
【问题原因】在性能较差的电脑上，程序和待处理数据均存放在读写速度较慢的移动硬盘上。合并分析时产生的大量I/O操作导致移动硬盘的读写性能达到瓶颈，严重影响了分析效率。 【解决办法】将程序和待处理的数据放置在本地高性能磁盘（如固态硬盘SSD）上执行，以提升I/O性能，从而解决分析速度慢的问题。

问题2：在二次开发中，通过布局模板出图，使用 MapLayout 对象的导出图片方法时，设置不同的DPI会导致地图的显示范围不一致。DPI为96时范围正常，DPI为200时范围变小。

12.0.0
【解决办法】通过代码设置布局中地图的比例尺（Scale）和中心点（Center）来精确控制出图范围。
mapLayout1.setMapcenter(geoMap.getID()，
new Point2D( x:119.25.
y: 50.5))
mapLayout1.setMapScale(geoMap.getID()，
scale:1/ 250000.0);

问题3：咨询在数据库型工作空间（PostgreSQL）中，哪张表存储了工作空间的相关信息。

11.3.0
【解决办法】对于PostgreSQL数据库型工作空间，工作空间信息存储在smworkspace表中，该表位于sdx模式（schema）下。

问题4：在iDesktopX二次开发中，调用坐标系设置对话框，当选择CGCS2000（EPSG:4496）坐标系后，界面上错误地显示为另一个坐标系（EPSG:32601），导致坐标系设置不正确。

12.0.0
【问题原因】程序运行环境中的 bin/SuperMap.xml 配置文件不完整或已损坏，导致坐标系相关功能异常。
【解决办法】从一个全新的、正常的iDesktopX解压包中，复制 bin/SuperMap.xml 文件，并覆盖到有问题的环境中即可恢复正常。

问题5：咨询超图产品是否有现成功能或实现方式，来满足铁路线上任意两点间连通性分析的需求，并能高亮显示连通路径。

11.3.0
【问题原因】iDesktopX桌面产品无法直接实现该需求。 【解决办法】通过iObjects组件进行二次开发，构建网络数据集，实现连通性分析功能。技术支持提供了相应的范例代码供项目参考实现。

问题6：在调用SuperMap iObjects Java组件接口时程序报错，咨询错误原因。

12.0.0
【问题原因】程序运行环境中缺少适用于SuperMap GIS 12.0.0版本的许可文件，或者现有许可文件已过期。 【解决办法】1. 检查许可中心，确认许可状态。2. 为目标机器申请并配置有效的V12版本许可文件。3. 如果环境中同时存在V11和V12两个版本，可以将两个版本的许可文件（.lic）都放置在公共许可目录下。

问题7：咨询如何使用iObjects Java组件实现实时计算沿指定路径（如北京到西安的铁路线）的当前点距离前方某个重要车站的剩余距离。

11.3.0
【解决办法】提供了两种后端实现思路： 1. 获取整条线路的节点集合，根据当前点位置，累加计算剩余路径上所有线段的长度。 2. 使用当前点坐标在线数据集上进行打断操作，生成两条新的线对象，直接获取代表剩余路程的线对象的长度属性。同时建议，此功能在前端实现会更简单高效。

问题8：在组件开发中，需要通过代码设置地图对象的压盖过滤显示选项，此前已通过技术支持的指导验证了功能可行性，现需要明确实现该功能的具体编程接口是哪一个。

11.3.0
【解决办法】设置地图压盖过滤显示的接口为Map.setOverlapDisplayedOptions(MapOverlapDisplayedOptions value)。此方法需与Map.setOverlapDisplayed(false)配合使用，即先通过setOverlapDisplayed方法关闭地图默认的压盖显示后，通过setOverlapDisplayedOptions接口传入的各项详细设置才会生效。

问题9：在使用某功能计算点到最近线对象的垂线时，未能成功生成垂线，希望了解其具体的计算逻辑和失败原因。

11.3.0
【问题原因】该功能的实现逻辑是：首先找到距离目标点最近的线要素，然后计算垂足。如果计算出的垂足落在了该最近线段的延长线上，而不是线段本身，则判定为无效，不会生成垂线。

问题10：咨询在使用iObjects Java对CAD数据集进行二次开发时，如何通过API代码修改文本对象的字体颜色。

11.3.0
【解决办法】通过遍历数据集记录集（Recordset），获取文本几何对象（GeoText），设置其文本风格（TextStyle）的颜色，然后通过recordset.edit()和recordset.update()方法将修改后的几何对象更新回数据集。

问题11：在Docker容器内安装超图组件产品的许可驱动时遇到报错。尽管容器与宿主机网络基本通畅，但组件许可未能正常读取和识别，导致服务无法使用。

11.3.0
【问题原因】容器内的许可配置文件（hasplm.ini）配置不正确，未能完整指向宿主机的硬件锁许可服务。 【解决办法】1. 确认容器与插锁机器（宿主机）网络互通。2. 将正确的许可配置文件放置到容器内的/root/.hasplm目录下。3. 修改配置文件中的serveraddr参数，将其值设置为宿主机的IP地址，并根据实际情况补充端口号等信息。

问题12：使用iObjects for Java组件导入DXF文件时，程序抛出异常并报错，导致数据导入失败。

11.3.0
【问题原因】程序在执行导入操作时，未能成功读取到有效的iObjects组件许可，导致功能调用失败。 【解决办法】请检查应用程序所配置的许可文件是否正确，并确保许可的版本、状态（是否激活、是否在有效期内）等均无问题。

问题13：在aarch64架构服务器上，iObjects 11.2.1-linux-arm64连接启用了Yukon的高斯数据库时，若数据存储在自定义schema下则连接失败，而iDesktop连接正常。

11.2.1

【问题原因】11版本不支持除public外的模式创建的数据库
【解决办法】使用public进行存储数据。

问题14：计划升级使用iObjects Java 12.0.1版本，但在CentOS 7系统中因glibc版本过低而无法运行，寻求兼容版本或解决方案。

12.0.0

【问题原因】iObjects Java 12.0.1版本运行需要较高版本的glibc库，而CentOS 7系统自带的glibc版本过低。
【解决办法】可以参考官方技术博客提供的解决方案进行处理：https://blog.csdn.net/supermapsupport/article/details/156266496

八、SuperMap iClient for JavaScript

问题1：咨询Web端是否有功能可以直接编辑地图服务中的数据，并希望能提供相关实现案例。

11.3.0
【解决办法】地图服务本身不支持直接编辑，但可通过组合服务实现。首先通过对地图服务进行空间查询获取到要编辑的要素，然后在前端进行绘制编辑，最后通过数据服务将编辑后的结果更新回服务器。参考示例：https://iclient.supermap.io/examples/classic/editor.html#query_editFeature

问题2：咨询在Web端进行数据编辑时，是否支持对要素节点的捕捉功能，以提高编辑精度。

11.3.0
【解决办法】SuperMap iClient for JavaScript产品在Web端编辑时提供要素捕捉功能，可以捕捉到点、线、面的节点或边界，方便进行精准编辑。

问题3：使用iClient for JavaScript（Leaflet）加载MapServer发布的WMTS服务时，地图初始化时所有瓦片请求均报404错误，且请求的图片格式为非期望的avif格式。必须手动缩放到最小级别后地图才能正常显示。

11.3.0
【问题原因】在iClient for leaflet中添加4490坐标系WMTS服务时未自定义坐标系且未添加正确的origin和bounds，导致WMTS服务加载异常。
【解决办法】提供了正确的加载代码用于参考：

问题4：在Web项目中加载一个CGCS2000（EPSG:4490）坐标系的湖南省行政区划WMTS服务时，该图层位置发生严重偏移，显示在了俄罗斯区域。经排查，底图使用的是Web墨卡托坐标系的天地图服务。

11.3.0
【问题原因】底图（Web墨卡托坐标系）与叠加的业务图层（CGCS2000坐标系）坐标系不一致，导致客户端无法正确配准和叠加显示。 【解决办法】将底图天地图的服务地址由Web墨卡托版本（ter_w）更换为CGCS2000经纬度版本（ter_c），确保所有图层使用统一的坐标系。

问题5：咨询如何通过点击行政区要素作为查询条件，实现对地图数据的空间查询，并希望能提供相关功能的实现示例。

11.3.0
【解决办法】可以借助几何查询功能实现该需求。具体实现逻辑如下： 1. 首先，通过点选查询功能查询所点击的行政区，从而获取其几何属性信息。 2. 其次，将获取到的行政区几何数据作为空间查询的条件，去查询目标图层中的数据。 可参考官方示例：https://iclient.supermap.io/examples/leaflet/editor.html#02_getFeatureByGeometry

问题6：咨询如何在Web端（Leaflet）加载并能移除一个包含岛洞（即带有内环）的GeoJSON格式的面状要素。

11.3.0
【解决办法】提供了完整的Leaflet示例代码。核心是使用L.geoJSON()方法加载符合GeoJSON规范的带岛洞的Polygon数据。移除时，需先保存L.geoJSON返回的图层对象，然后调用地图实例的removeLayer()方法并传入该对象即可。

问题7：在使用OpenLayers加载超图服务进行开发时，希望对客户端的线图层进行裁剪操作，并能获取裁剪后线段的长度，咨询是否有相关的前端API接口。

11.3.0
【解决办法】前端iClient产品没有提供直接裁剪并计算长度的接口。建议调用iServer的空间分析服务（矢量裁剪），该服务会将裁剪结果生成为新的数据集，然后从结果数据集的属性中读取长度字段（如SmLength）即可。

问题8：访问iClient for OpenLayers官方示例，执行与分布式分析服务相关的代码（如属性汇总分析）时，程序一直处于等待状态，没有返回结果。

11.3.0
【问题原因】官方示例环境中，一方面是服务Token已失效，另一方面是并未发布对应的分布式分析服务。 【解决办法】用户需要自行搭建iServer环境，发布分布式分析服务，并在示例代码中替换为自己的服务地址和有效Token来进行测试。

问题9：使用OpenLayers加载iServer发布的同一份影像数据服务时，WMS服务与底图匹配正常，但REST地图瓦片服务（ImageTileSuperMapRest）与底图存在错位。

11.3.0
【问题原因】影像数据的3857坐标系不标准，导致iServer发布的服务默认按标准坐标系加载时出现源点错误，从而产生偏移。 【解决办法】在前端OpenLayers加载图层时，通过添加tileGrid参数，并根据iServer服务元信息中的信息显式设置正确的origin（源点），将影像瓦片服务校正到正确位置。

问题10：在Leaflet开发的WebGIS应用中，当地图上加载约2000个点（图片和动态图）时，地图渲染和缩放操作变得非常卡顿，寻求优化方案。

11.3.0
【问题原因】使用L.marker方式加载大量点要素时，会生成大量的DOM元素，导致浏览器渲染性能下降，从而引起卡顿。 【解决办法】1. 使用聚合图层（MarkerCluster）来减少同屏显示的DOM元素数量。2. 使用Canvas方式渲染点（如leaflet-canvas-marker插件），以提高渲染性能。

问题11：客户需要在Web前端实现使用绘制的不规则线来分割一个不规则面，例如用两条线将一个面分割成三个面。面和线对象均为在前端临时绘制，非服务端持久化数据。

11.3.0
【问题原因】iClient for JavaScript 或其底层的Leaflet库本身不直接提供“线分割面”的现成工具。 【解决办法】该功能需要进行二次开发实现。建议采用前端开源库组合的方式：1. 使用 leaflet.draw 插件来支持用户在地图上绘制面和线。2. 使用 Turf.js 库进行空间分析，通过其提供的几何计算能力（如计算线与面的交点、构建新的多边形等）自行构建切割逻辑，最终生成分割后的面对象并在前端展示。

问题12：通过npm方式安装并使用@supermapgis/iclient-ol包，在加载矢量切片服务时，浏览器控制台报错window.olms未定义，导致图层添加失败。

11.3.0

【问题原因】以npm模块化方式使用@supermapgis/iclient-ol时，其依赖的ol-mapbox-style库需要被显式引入才能正常工作。
【解决办法】在项目代码中单独引入ol-mapbox-style库即可。具体引入方式可参考官方博客：https://blog.csdn.net/supermapsupport/article/details/156222024

问题13：咨询在基于Leaflet的二维WebGIS应用中，如何实现对场数据（如风场、流场）的动态流线可视化效果。

11.3.0

【解决办法】参考“leaflet风场流线型前端插件”博客：https://blog.csdn.net/qq_35131811/article/details/8276123

九、SuperMap 其他

问题1：咨询超图GIS平台与国产数据库人大金仓和达梦的适配度，以及在选型上哪款数据库更受推荐。

11.3.0
【解决办法】超图GIS平台与人大金仓、达梦数据库均已完成适配，兼容性良好。在数据库选型上没有特别推荐，用户可根据项目实际情况和需求自行选择。

问题2：咨询如何为已激活正式许可的Web许可中心生成许可销毁证明文件，以便重新申请许可。

11.3.0
【解决办法】登录Web许可中心管理页面，点击“清除许可”按钮，按提示输入确认字符后，浏览器会自动下载包含销毁证明的c2s文件。此文件可用于申请换货。

问题3：咨询SuperMap AI扩展功能包是否提供Linux版本，以用于遥感解译、二元分类等功能。

11.3.0
【解决办法】SuperMap AI扩展功能包提供Linux版本，支持人员已将对应的产品包信息提供给用户。

问题4：在Web许可中心（bslicense linux x64 v4.0.6）导入许可文件时，iDesktopX和iPortal等模块在“按核”分配的选项中显示为灰色不可选，用户不理解其原因。

11.3.0
【问题原因】产品设计如此。iDesktopX和iPortal产品没有按核计费的许可模式，只有按套计费的模式。 【解决办法】此为正常现象，用户无需特殊操作。对于iDesktopX和iPortal产品，只能在“按套”许可类型下进行选择和分配。

问题5：咨询线数据集中，单个线对象的节点数量是否存在理论上限，以及在实际应用中的推荐值和遇到过的最大节点数是多少。

11.3.0
【解决办法】产品设计上没有对单个线对象的节点数设置硬性限制。从性能和稳定性考虑，建议将节点数控制在四位数以内。实际项目中遇到过的最大节点数约为5万个。

问题6：咨询同一个网络许可锁中如果同时包含开发许可和运行许可，是否可以在客户端进行配置，区分或指定使用哪一种类型的许可。

11.3.0
【解决办法】无法在客户端对同一个网络锁中的不同类型许可进行选择性配置。推荐的管理方式是将开发许可和运行许可分别部署在两台不同的许可服务器上，客户端通过连接不同的服务器IP来使用指定类型的许可。

问题7：咨询在更换正式许可文件的流程中，如何通过许可中心清理现有许可并生成C2S文件，但在操作“清除许可”后未找到生成的C2S文件。

11.3.0
【问题原因】用户在没有正式许可的情况下，测试许可更换流程。“清除许可”并生成C2S文件的操作仅适用于已绑定“机器名+MAC地址+机器码”的正式许可。 【解决办法】明确了该操作的前提条件，用户当前没有正式许可，无需执行此操作。

问题8：用户反馈项目许可在节后已过期，导致项目无法正常使用，请求技术支持加急处理许可续期事宜。

11.3.0
【解决办法】技术支持内部协调加急处理了用户的许可申请流程，并将生成的最新许可文件通过邮件发送给了用户。

十、SuperMap iMobile Android

问题1：咨询在iMobile for Android产品中，如何实现类似百度或高德地图的离线地图功能，即用户可以选择一个特定区域范围，然后将该范围内的地图数据下载到本地供离线使用。

11.3.0
【解决办法】参考超图官方提供的iMobile离线地图下载示例代码。该示例详细演示了如何实现地图数据的下载、管理和离线加载功能。具体链接为：http://support.supermap.com.cn:8090/web/learning/learning_MobileGIS91.html

问题2：移动端查询使用子类型或属性域管理的图层字段时，返回的是编码值。咨询如何获取编码对应的描述信息。

11.3.0
【问题原因】移动端SDK查询子类型或属性域字段时，默认返回编码值，SDK本身不提供直接解析为描述信息的功能。 【解决办法】需要在应用层自行配置映射关系（如JSON文件），通过编码值手动查询匹配对应的描述信息。

问题3：咨询移动端SDK从11版本升级到12版本需要进行的适配工作，包括许可、接口变更、库文件替换以及改造工作量等。

11.3.0
【解决办法】1. 11版本和12版本的许可不兼容，需要申请并更换为12版本的许可。 2. 移动端产品的接口基本没有变化，代码改动量很小。 3. 项目中引用的SDK相关的JAR包和SO库文件必须替换为12版本对应的文件。

问题4：在进行移动端环境初始化时，调用Environment.initialization(mContext)方法报空指针异常（NullPointerException）。

11.3.0
【问题原因】根据堆栈信息分析，报错发生在Activity实例化调用失败，是由于项目本身创建Activity的逻辑不正确导致的，而非SDK问题。 【解决办法】建议参考超图官方提供的iMobile for Android示例程序的项目创建和Activity调用逻辑进行代码排查和修正。

十一、SuperMap Unreal Engine

问题1：在UE平面场景中，咨询是否可以将经纬度坐标转换为UE坐标。后续明确为需要将墨卡托投影坐标转换为UE坐标，以实现模型在场景中的精确定位。

11.3.0
【问题原因】产品未直接提供墨卡托坐标到UE坐标的转换接口。 【解决办法】提供转换换算方法：(查询的投影坐标 - 坐标偏移) * 100，然后对X和Y坐标进行颠倒处理。

问题2：使用切换Pawn版本的新UE插件后，项目在编辑器中运行正常，但打包后的程序无法显示WMTS和天地图等服务图层。同时，工具栏图标也显示为空白。

11.3.0
【问题原因】项目打包时，部分资产文件未被正确烘焙和渲染。 【解决办法】在项目打包设置中，将相关资产文件路径添加到“要烘焙的附加资产目录”(Additional Asset Directories to Cook)中，进行额外渲染和烘焙，解决服务不显示和UI图标空白的问题。

问题3：咨询Hi-Fi-3D-SDK-for-Unreal打包的项目，在配有多张Quadro P4000显卡的服务器上，是否能调用显卡资源进行视频流推送。

11.3.0
【解决办法】Quadro P4000 估计可勉强运行 UE 轻量级项目，但高复杂度场景的开发、打包和像素流送这些会有压力的。
UE插件标准配置：Nvidia Geforce RTX 3070 同等或更高配置。
UE插件推荐配置：Nvidia Geforce RTX 4090 同等或更高配置。

十二、SuperMap Yukon

问题1：咨询用于部署AI（AgentX及大模型）的四台海光X86服务器硬件配置是否满足产品要求。客户环境将对接阿里提供的政务网千问大模型服务。

12.0.0
【解决办法】经确认，AgentX产品已适配过海光服务器，硬件配置满足要求。由于大模型服务由阿里直接提供，超图侧仅需部署AgentX产品包即可。后续已安排会议讨论具体部署事宜。

问题2：咨询SuperMap产品对国产崖山（Yukon）数据库的支持情况，包括支持的版本以及支持导入的数据类型（如模型、矢量等）。

11.3.0
【解决办法】经与研发确认，SuperMap GIS平台支持向崖山数据库导入除栅格数据集外的所有数据集类型，这其中也包含了三维数据集（如模型、点云等）。

问题3：用户在Yukon中有一个未切片的矢量图层（临时分析结果），希望将其直接生成为一张图片供下载，因为数据量较大，前端绘制效率低。咨询是否有直接生成缩略图的GPA算子或其他方法。

11.3.0
【问题原因】Yukon产品中当前没有直接将分析生成的矢量结果集导出为单张图片的工具。 【解决办法】建议将该矢量图层数据入库并保存为地图，然后通过iServer发布为REST地图服务。最后，通过调用服务的image资源接口即可直接输出图片。如果对输出图片格式有更高要求，也可以使用Web打印功能。

十三、SuperMap iObjects .NET

问题1：咨询在没有安装iDesktopX等超图软件的环境中，是否能修改数据库型工作空间（PostgreSQL）的数据库连接参数（如IP、端口）。

11.3.0
【问题原因】数据库型工作空间的连接信息以二进制格式存储在工作空间文件中。 【解决办法】无法直接修改。必须通过超图的桌面或组件产品（如iDesktop, iObjects）提供的API来打开和修改其连接参数。

问题2：咨询iObjects .NET组件相关问题：1. 如何从镶嵌数据集中删除指定的单个影像文件。2. 使用代码修改线对象节点后，虽然显示正常，但无法通过空间查询检索到该对象。

11.3.0
1.【解决办法】通过DatasetMosaic.FootprintDataset.Query(SmPath=“…”)查询到对应影像的轮廓记录，然后调用deleteAll()方法删除。
2.【问题原因】更新几何对象的代码逻辑不正确，导致对象范围未能正确更新。
【解决办法】正确的更新流程为：获取Point2Ds -> 修改节点 -> 使用修改后的Point2Ds重新构建GeoLine -> 使用新的GeoLine更新记录。

问题3：在二次开发中，希望在界面上通过下拉列表实现批量操作，即循环执行封装好的方法处理下拉列表中的所有值，而不仅是当前选中的单个值。

11.3.0
【问题原因】产品设计的下拉框控件逻辑是选择一个值进行操作，不支持遍历所有值进行批量处理。现有界面无法直接实现该批量操作需求。 【解决办法】建议使用GPA建模功能，通过搭建模型来迭代数据集，实现批量处理。

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

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