一、SuperMap iServer
问题1：如何在iDesktopX中通过加载3dtiles数据并预览该三维数据，需获取实现方法。
11.3.0
【解决办法】iDesktopX12.1.1版本支持直接打开3dtiles数据。具体操作：在场景的图层管理追踪添加三维瓦片，选择json文件格式，再选择3dtiles数据的入口json文件即可。
问题2：iServer 11.3版本发布3D Tiles 1.1版本瓦片后服务内容为空，咨询该版本是否支持直接发布及解决方法
11.3.0
【解决办法】iServer支持发布3D Tiles 1.1数据，发布后服务内容不为空，需到服务datas节点下查看发布后的瓦片数据即可正常显示
问题3：iServer启动时报错，所有服务均未启动成功，此前运行正常，咨询报错处理方法
11.3.0
【问题原因 】之前配置过文件管理根目录并发布服务，后来误删了该配置，导致服务启动失败
【解决办法】重新设置文件管理根目录后重启iServer正常
问题4：iServer 11.3.0修改配置文件后重启导致正式许可读取不到，排查发现许可文件与当前机器两个MAC地址不一致，咨询解决方案
11.3.0
【问题原因 】机器的之前申请许可的网卡没了
【解决办法】需要找企管去申请更换许可，如果是机器的网卡会变，建议使用硬件锁或者是云许可
问题5：iServer 10.2发布文件型数据源地图叠加正常，切图到MongoDB（芒果库）后用其发布地图报投影不一致错误，寻求解决办法
10.2.1
【问题原因 】上层应用要求叠加的地图使用相同投影，动态服务支持动态投影而切片服务不支持，切片后投影不一致导致报错。【解决办法】先将数据投影到正确的目标坐标系下，再进行切片发布，即可正常使用
问题6：iServer启动时无明显错误，界面卡顿一会儿后启动过程直接闪退，咨询解决办法
11.3.0
【问题原因 】地形瓦片文件不规范导致了iserver闪退
【解决办法】1.重新生成地形瓦片，iserver不再闪退；2.客户目前是11.2.0，建议升级到11.3.0，高版本只会报错，不会闪退
问题7：iServer数据服务过滤设置查询条件"建筑物名称 = 'Ⅳ污水汽提装置3'"查询不到记录（featureResult为0），改用模糊查询可查到
11.3.0
【问题原因 】"建筑物名称"字段值最前面含空格，导致精确匹配查询条件查不到结果。【解决办法】使用iDesktopX"更新列"功能中的Trim函数处理字段删除空格后，精确查询即可正常执行。
问题8：调用iServer发布的知识图谱服务查询效率低，70多个关系的查询3分钟后失败并取消
11.3.0
【问题原因 】查询语句语法错误导致查询失败。【解决办法】修改查询语句后报错解决：MATCH p=(n:tim_jsydsp{XMMC:'${namesStr}'})-1...3-(m) WHERE ANY(label IN labels(m) WHERE label IN 'tim_yjjbnt',...) RETURN p；性能优化建议：查询语句中限定关系类型（如r:农转征_土地供应1...3）缩小搜索范围，并为XMMC属性创建索引
问题9：iServer执行shutdown后再次启动，出现服务不能访问的情况
11.3.0
【解决办法】确认iServer进程杀干净后再重启：Linux下用 ps -ef ｜ grep iserver 查看iServer进程，若没杀干净使用 kill -9 PID结束进程后再重启
问题10：知识图谱服务查询结果界面中红框标注的内容代表什么含义
11.3.0
【解决办法】红框内容是数据查询时的被查询数据，格式为"数据源名称:数据集名称"
问题11：文件型工作空间在iServer上上传时报"超过文件大小限制"错误，1.4G压缩包无法上传
11.3.0
【解决办法】增大【iServer安装目录】/webapps/iserver/WEB-INF/iserver-system.xml中的uploadSize和uploadUnzipSize参数（单位为MB，默认值偏小需调大）后重新上传
问题12：知识图谱图斑数据服务发布成功后，不知在页面上点哪个入口查看图斑数据内容
11.3.0
【解决办法】需要通过数据服务的featureResults资源查看图斑数据
问题13：发布服务时无法选择REST数据服务类型，关闭工作空间后仍然不能选择，上传数据发布失败
11.3.0
【问题原因 】选择"上传数据"方式发布服务时，上传的包中仅有工作空间，没有数据源。【解决办法】将工作空间与数据源文件一起打包上传，重新发布服务
问题14：昨日SMID为207的线要素修复后可更新，但SMID为211（及206）的要素又出现无法更新空间字段的同样问题，问题重复出现
11.3.0
【问题原因 】数据库表实际91条而iServer与iDesktopX显示227条，系此前直接使用SQL/DBeaver删除数据、未通过features接口删除导致注册表关联内容未清理干净，非正常删除的要素（227以内）更新可能失败
【解决办法】在iDesktopX上该数据集右键刷新，更新数据集对象数量后再更新数据即可成功。后续对数据做添加、删除与修改操作，参考REST接口文档：https://help.supermap.com/iServer/zh/mergedProjects/SuperMapiServerRESTAPI/root/data/datasources/datasource/datasets/dataset/features/features.htm
问题15：河南省平台8090端口iServer本周再次出现假死问题，涉及业务对接，提供问题截图请优先排查
11.3.0
【问题原因 】结合iServer服务访问记录排查发现，在60s内有1w+请求打到iServer，导致iServer无法完成响应继而假死
【解决办法 】1、异常流量冲击且溯源困难：监测到1分钟内超10,000次异常高频数据查询请求。由于用户侧未透传真实IP，目前无法定位请求来源客户端，难以从源头阻断。
2、单机多实例资源争抢：该服务器共部署6个iServer实例（含三维、空间分析等服务）。虽然内存充足，但高负载下CPU资源存在严重的跨实例争抢问题，影响整体稳定性。
3、地图服务负载过重：单节点承载700+地图（分布于十余个工作空间），其中包含10余个河南全省地类图斑动态出图服务，渲染开销巨大。
4、缓存策略缺失：约50%的工作空间地图服务未开启缓存，长期依赖动态出图，服务器可能持续处于高计算压力状态。
【解决办法 】1、全链路日志追踪（对应风险1）：已提供完整的高频请求定位方案，通过关联日志识别实际客户端IP及发起原因。（09.24 17:00 现场反馈已定位到异常高频请求来源）
2、Nginx网关限流（对应风险1）：在Nginx层配置速率限制，控制单位时间内流向单节点iServer的请求量，防止瞬时击穿。
3、集群负载均衡与部署规范（对应风险2，3）：新增iServer节点并通过Nginx搭建负载均衡集群，分散单点压力。不建议在同一台物理机上部署多个iServer实例。
4、全省图斑预切片（对应风险3）：避免全省地类图斑直接动态出图，应执行预缓存处理。
5、开启地图缓存（对应风险4）：对高频访问的必要地图服务强制开启缓存，降低实时渲染压力。（已实施）
通过落实上述解决建议，现场环境iServer频繁假死问题已经解决。
问题16：项目上 iServer 近期频繁异常不可用，两天内出现三次服务挂掉，前端业务系统反馈地图调用不到，但监控显示内存和 CPU 均未耗尽，重启后恢复正常，需定位崩溃原因。
11.2.1
【问题原因 】11.3.0禁用缓存再启用会使用SMTiles，高并发下就会出现sqlite占用问题
【解决办法】高并发情况下建议使用UGC缓存了，重新启动缓存的时候注意修改成UGC缓存类型
问题17：使用iServer的webprinting服务打印MultiPolygon类型的GeoJSON数据并自定义颜色时，多点/多面要素无法显示；打印单点点、线、面要素均正常，需获取MultiPolygon类型自定义颜色的打印示例。
11.3.0
【解决方案】MultiPolygon示例：MultiPolygon_geojson_rest.jsonMultiPolygon.wrapped.geojson
问题18：升级到 iServer 2026 后 REST 地图服务在前端不显示，老版本 iServer 2025 使用同样代码可正常显示三个地图服务中的两个
12.1.0
【问题原因 】新版本发布服务时配置了 dpi 为 210，前端 TileSuperMapRest.optionsFromMapJSON 方法会依据 dpi 计算分辨率，算出的分辨率与地图对象分辨率不一致导致图层叠加不上；对比新旧版本请求可见 tileImage 请求中的 scale 相差近一个数量级。【解决办法】将发布服务的 dpi 改回推荐值 96（与天地图一致，一般情况下保持默认即可），重新发布后三个地图服务前端均可正常显示；同时明确地图与其他图层投影建议保持一致，不建议使用 OpenLayers 动态投影
问题19：咨询临时图层下子图层显隐控制的实现方式：需要在临时图层过滤的基础上再实现子图层控制，而非新建图层
12.1.0
【问题原因 】客户误以为子图层控制需要在过滤图层之外再创建一个图层；实际临时图层与过滤图层属不同对象，layersID 配置不同且互不影响。【解决办法】图层对象本身提供控制显示隐藏的属性，直接修改已有临时图层的子图层该属性即可实现子图层显隐控制，修改后更新临时图层信息并刷新地图即可生效，无需新建图层
问题20：咨询 REST 服务的 token 无效问题如何调整授权配置
12.1.0
【问题原因 】服务未开启授权访问，匿名用户即可访问，导致 token 校验形同无效。【解决办法】按实际需求二选一配置：如需权限控制则在服务管理中开启授权访问并配置 token，如无需控制则保持匿名可访问；配置后 token 即可对 REST 服务生效
问题21：项目业务需根据点线面图层配置地图（约15个图层），矢量数据需动态更新维护，咨询应切矢量瓦片发布后配置动态更新，还是切地图瓦片发布服务定时手动更新，矢量瓦片服务性能如何及有无更优方案
11.3.0
【解决办法】SuperMap iServer提供矢量瓦片自动更新功能，可实现"后端数据库数据更新后，前端访问的矢量瓦片服务自动刷新"，即定期检测数据变化、清除/刷新MVT旧缓存、过期瓦片按新数据重新出图；选用矢量瓦片还是栅格瓦片取决于项目是否有地图交互查询与样式处理等需求。参考：矢量瓦片自动更新 https://ima.qq.com/share/#/knowledge-base-chat/YR48x72Wr
问题22：mdb 数据中面层与注记层之间没有关联字段，需按"注记点落于面内"的空间关系把注记文字赋到面属性上，并识别面内无注记、一个面多个注记、注记不在面内等异常情况反馈作业人员。
12.0.0
【问题原因 】GPA 属性更新算子的空间关系配置为"包含"，而点要素不能包含面要素，配置反向导致算子报错、赋值失败；同时面层为三维面、注记层为属性表类型，均不满足算子输入要求。【解决办法】先将注记层转换为点数据、面层由三维面转换为二维面；属性更新算子的空间关系改为"被包含"，即注记点被面包含；再针对面内无注记、多注记、注记不在面内的情形增加判断分支，将异常结果反馈给作业人员核对。
问题23：源数据为 mdb，只读打开无法新增字段，需先导入临时 udb 再处理；但导入时无法只筛选某个图层，注记层与面层一并导入，且临时文件名称不固定，GPA 模板无法固定选择面层。
12.0.0
【解决办法】已确认 mdb 数据源为只读方式打开，不支持写入字段，须先将数据导出为支持写入的数据库型或文件型数据源数据集，处理完成后回写；当前项目采用先导入临时 udb 的方式绕行。
问题24：面层上存在多个注记时，属性赋值结果如何确定，是否会随机取值；若源数据本身不是三维数据，模型中保留三维转二维步骤是否会报错。
12.0.0
【问题原因 】多注记场景下算子默认"直接赋值"取值方式只写入其中一个注记值，其余被丢弃；源数据本身为二维时，模型中再执行三维转二维会因输入维度不匹配报参数不合法。【解决办法】多注记场景在属性更新算子中设置合适的取值方式（如按距离、首值等）以明确取值规则；对源数据维度做前置判断，二维数据跳过三维转二维步骤，或按数据类型拆分两条处理分支。
问题25：GPA 中发布模型后在 iServer 界面找不到模型入口，也不清楚应把哪个服务地址提供给开发调用。
12.0.0
【解决办法】发布的模型在 GPA 的"模型工具"菜单下查看与管理；开发调用方式与地址格式参见官方博客 https://blog.csdn.net/supermapsupport/article/details/144022025 ，按文档中的 geoprocessing restjsr gp v2 接口规范对接。
问题26：style.json 经181 VIP 节点代理后，文件内地址被替换为 https://10.10.167.33，而各子节点获取到的内容替换正常，客户在 nginx 中未找到对应配置。
12.0.0
【问题原因 】181 节点的 openresty 对 style.json 增加了特殊改写规则，用于绕开 stylejson 中第三方 url 被替换为 iServer IP 与端口的问题，因此 VIP 与子节点返回内容不一致。【解决办法】检查 /usr/local/openresty/nginx/conf/style.json 中的改写配置，与添加该代理规则的同事确认后按实际访问地址调整即可。
问题27：日本客户日立开展 PHP 安全漏洞自查，来函确认其运行系统所使用的 SuperMap iServer 产品及地图慧在线服务 API（中国瓦片地图、坐标系转换、坐标与地址互转）是否在系统架构中使用 PHP 及 PHP 实现的 API 端点
11.3.0
【解决办法】经确认 SuperMap iServer 产品架构未使用 PHP，不存在由 PHP 实现的 API 端点。
问题28：安装 iServer 11.3 后启动页面一直处于 loading 状态，无法进入管理界面
11.3.0
【解决办法】清理浏览器缓存、改用 Chrome 浏览器访问；
问题29：10i 版本 iServer 的地图缓存如何清理，删除缓存后是否需要重启服务
10.2.1
【问题原因 】iServer 地图缓存按地图分目录与地图名前缀文件存放在部署目录的 output/cache 下。【解决办法】进入 supermap-iserver-10.2.1-windows-x64-deploy\webapps\iserver\output\cache 目录，删除对应地图的文件夹及以地图名开头的相关文件即可，无需重启服务。
问题30：iServer 12 环境部署下，倾斜摄影模型用 iDesktopX 切片并搭建三维场景是否存在版本兼容问题
12.0.0
【问题原因 】三维缓存格式与桌面端、服务端版本相关，跨大版本混用可能造成场景加载异常。【解决办法】优先使用同一版本；无法统一时保证 iDesktopX 版本小于等于 iServer 版本，11.3 版桌面配合 12 版 iServer 可正常搭建场景。
问题31：iServer进入服务管理后无法进入服务接口，查看服务详情一直卡在加载，重启服务也卡在加载无法重启（无痕模式、控制台网络请求排查均未直接定位），请求远程协助
11.3.0
【问题原因 】停止服务时有进程残留，重启不成功导致服务无法使用。【解决办法】停止服务后等待20秒左右再启动，或使用命令排查并清除残留进程后再启动服务；后续遇到服务不可用时先不重启，先排查清除导致不可用的原因后再解决
问题32：基于人大金仓数据源发布的服务中，表名多出"（面）"字符，导致数据服务调取失败、空间分析无法执行
11.3.0
【解决办法】数据不同步，删除服务后重新发布即可生效
问题33：iServer 启动约一两分钟后自动断联退出
11.3.0
【问题原因 】服务器内存占用过高，剩余可用内存仅 2G，iServer 启动后因内存不足被终止，表现为启动一分多钟即断联。【解决办法】关闭服务器上占用内存过多的其他程序释放内存后重新启动 iServer，服务稳定运行不再崩溃；建议后续对服务器扩容内存。
问题34：某一工作空间可打开并编辑地图，但无法修改也无法保存，重启与清理缓存均无效
12.0.0
【问题原因 】客户使用 QTXK数据库打开工作空间，但工作空间实际保存在 postgres 数据库中。
新版本中，打开工作空间时会先找用户传入的 QTXK，找不到再找 postgres；但保存工作空间时只认用户传入的 QTXK，不再查找 postgres。因此出现"能打开编辑地图，但无法保存"的现象。
【解决办法】打开工作空间时显式指定 postgres 数据库连接，即可正常修改与保存。
问题35：ArcGIS 瓦片聚合服务在 iServer 12 下是否还需调整 XML 配置，切片子服务勾选启用瓦片缓存后是否仍会重复生成缓存
12.0.0
【问题原因 】聚合服务中切片子服务的地图提供者缓存开关未关闭时会重复触发切片生成。【解决办法】将地图提供者的 cacheEnable 参数设置为 true，即不再生成新缓存，iServer 12 沿用该配置方式，无需再改动其他 XML。
问题36：许可锁显示 9 个节点，但客户实际只能使用 5 至 6 个，需确认可用节点数量与授权类型
11.3.0
【解决办法】许可锁共 9 个，其中 5 套标准版可用于主节点或单机 iServer，4 个服务节点扩展模块只能作为子节点使用。
问题37：云套件开启重采样后，线图层出现截断、错位现象，属于升级阻断类缺陷，需在客户现场版本中验证修复效果。
12.0.0
【问题原因 】旧版本云套件在开启重采样时对线图层的瓦片边界处理不当，导致线要素跨瓦片处被截断并产生错位。【解决办法】使用修复后的云套件版本（缺陷 ISVJ-12530 已修复），在现场环境完成版本功能验证，确认开启重采样后线图层显示连续、无截断错位，验证通过。
问题38：业主单位下发关于 iServer 任意文件读取漏洞的公众号文章，客户询问该漏洞的修复方式与受影响版本范围，需要给出可直接落地的升级或修补方案。
11.1.0
【问题原因 】客户现用 iServer 版本早于官方漏洞修复版本，存在任意文件读取漏洞，可被利用读取服务器本地文件。【解决办法】将 iServer 升级至 2023-08-30 之后发布的版本即可修复，11.1.1 及以上版本不受该漏洞影响；漏洞详情与修复指引见 https://doc.weixin.qq.com/doc/w3_APoA7QahAB0lXYh6prZQRiA2A0bY5
问题39：客户咨询 iServer 平台是否支持 IPv6 网络环境部署与访问，用于确认项目网络改造方案。
12.0.0
【解决办法】iServer 支持 IPv6。
问题40：使用 GPA 对 tif 影像自动化发服务时，不清楚流程中所需的图层属性模板与工作空间文件这两个模板应如何准备。
12.0.0
【解决办法】图层属性模板可直接沿用此前操作录屏中提供的模板文件；工作空间文件无需特殊配置，在桌面端新建一个空工作空间并保存为 smwu 文件即可作为流程参数使用。
问题41：GPA 自动化流程执行失败，日志显示在"创建数据集"步骤报错，客户对比参数后仅目标数据源与录屏中不同，无法自行定位原因。
12.0.0
【问题原因 】客户当前用户没有权限在smbandregister_smbandid_seq序列表中添加数据
【解决办法】增加当前用户的读写权限或者更换拥有权限的其他用户连接.
问题42：客户在开发中需要获取 data 服务的数据表字段配置信息，询问已发布的地图服务是否提供可直接返回字段列表的 REST 接口，用于前端动态构建查询条件。
11.3.0
【问题原因 】地图服务未提供直接查询数据字段配置的接口，仅提供要素查询能力。【解决办法】通过地图服务的 queryResults 接口查询要素，从返回结果的属性字段中间接获取字段名称与结构；查询时限定返回单个要素并设置只返回属性、不返回几何，可降低传输量并提升效率。
问题43：客户咨询要素查询的查询条件如何设置才能保证效率，以及在图层暂时没有数据的情况下，能否通过地图服务返回字段结构供前端使用。
11.3.0
【解决办法】查询时限定查询单个要素，并通过参数设置仅返回属性信息、不返回几何信息，可显著提升查询效率；若图层无数据，地图服务无法返回字段信息，需先保证数据源中存在可用要素后再查询。
问题44：工作空间内多幅地图一并发布地图服务后，客户希望对其中部分地图单独切片，并希望属性查询与瓦片加载使用同一个服务地址，询问具体的切片与缓存配置方式。
11.3.0
【解决办法】1、将工作空间发布为地图服务；2、在服务配置中开启地图缓存并指定缓存目录；3、对需要加速的地图单独切片，将切片结果按地图名称命名文件夹放入上述缓存目录，即可在同一服务地址下同时实现属性查询与瓦片加载。
问题45：客户咨询同一服务下多个地图的切片能否放在同一目录、不同服务的缓存路径能否分别配置，以及切片缓存是否可以存放在 MongoDB 中，切片占用存储较大时的推荐存放方式。
11.3.0
【解决办法】同一服务下的多幅地图切片可放在同一缓存目录，按地图名称分文件夹管理，不同服务建议分别配置缓存路径避免混放；缓存目录路径支持按服务修改。切片缓存功能上支持 MongoDB 存储，但开源数据库不满足信创要求，建议使用本地磁盘并按数据量规划独立存储空间（同类项目按 6TB 本地磁盘规划）。
问题46：客户依据招标文件中的功能需求，询问 iServer 的三维网络分析服务能否支撑该需求，以及产品体系中网络分析模块与三维网络分析的区别与可用性。
11.3.0
【问题原因 】iServer 产品体系中仅提供网络分析服务模块，没有独立的"三维网络分析服务"模块，网络分析模块的能力已可满足该招标需求。【解决办法】经核实网络分析模块满足标书要求，且中心已采购该模块，在 iServer 中确认网络分析模块为可用状态后即可直接发布网络分析服务使用。
问题47：通过服务对数据做删除操作时报错，刷新、重启服务均无效；数据库更新过字段，新增的两个字段在删除/新增操作中均报错，其余字段正常
11.3.0
【问题原因 】数据库中新增字段名为大写，服务查询对字段大小写敏感，导致按新字段的删除、新增操作报错。【解决办法】将数据库字段名统一改为小写，并重启/刷新服务使服务读取到新的字段结构，操作恢复正常
二、SuperMap iDesktopX
问题1：用户三维道路场景使用路由数据，生成路由面板不能选择三维线；校准参考点为公里桩和百米桩刻度值时路由校准不成功
11.3.0
【解决办法】客户的校准参考点数据为公里桩和百米桩的刻度值，在【校准路由】时需选择校准方法为"按刻度值校准"；此外根据桩距离路由的距离，需将容限设为0.0001-0.0002左右，即可完成路由刻度的校准
问题2：三维标签专题图贴地旋转切缓存参数写到了工作空间，添加图层时贴地旋转设置丢失，能否写进图层
11.3.0
【解决办法】专题图设置的风格及场景中设置的属性参数都保存在场景中，最终需保存场景，对场景生成瓦片，之后使用生成的工作空间使用，单独只添加瓦片图层不会保留这些设置。建议以标签专题图生成的工作空间和场景为基础，向该场景中添加其它瓦片图层。
问题3：OSGB倾斜摄影模型执行倾斜入库或裁剪后变模糊且加载较慢
11.3.0
【问题原因 】倾斜摄影三维模型做了数据修饰，粗糙层纹理粗糙
【解决办法】生成配置文件时，重新指定根节点，指定较倾斜层作为根节点解决模糊问题
问题4：需要iDesktopX 10i最新双周包对应的ARM架构deb安装包，咨询应向谁申请获取
10.2.1
【解决办法】提供下载链接： https://pan.baidu.com/s/1oz_QYLnn7Hgk4B7KKxMWjQ 提取码: 7het
问题5：咨询iDesktopX能否像ArcGIS用gdb数据拉伸白膜一样，根据字段对白膜外观进行分颜色渲染
11.3.0
【解决办法】iDesktopX支持按字段分色渲染白膜，在线性拉伸设置时可以根据字段值设置白膜的颜色，实现与ArcGIS类似的分颜色渲染效果
问题6：对线数据集执行数据合并操作时iDesktopX桌面闪退，咨询闪退原因
11.3.0
【问题原因 】线数据集存在拓扑错误
【解决办法】数据合并前，使用线性拓扑预处理进行处理，拓扑规则说明可查看帮助文档：https://help.supermap.com/iDesktopX/zh/tutorial/DataProcessing/Topology/TopoProcess.html
问题7：iDesktop对DEM栅格数据集进行合并，使用栅格镶嵌合并12个栅格数据集预计需11天，咨询更高效的合并功能以合并后生成地形瓦片
11.3.0
【解决办法】单独对每份栅格数据集生成TIN瓦片，保持TIN瓦片开始层与结束层一致，然后使用合并TIN数据进行合并，效率比栅格镶嵌高
问题8：iDesktopX桌面进行符号库迁移时，迁移过来的符号与ArcGIS中原符号显示不一致，咨询解决方法
11.3.0
【问题原因 】系统中没有符号依赖的字体库。
【解决办法】下载该字体库后，右键通过管理员方式安装，安装完成后重新迁移即可。
问题9：咨询在iDesktopX里如何实现字体加掩膜（描边）的显示效果
11.3.0
【解决办法】在"字体效果"设置区域勾选"轮廓"复选框，即可控制标签专题图中标签对象（文本对象）文字是否有轮廓线，实现文字描边修饰效果。
问题10：美洲哥斯达黎加GEOINN客户iDesktopX许可解密失败，底层解密代码修改后旧版本包无法解密许可，且客户需英文版产品包验证
12.0.0
【问题原因 】近期底层修改了解密代码，旧版本产品包导致许可解密失败。【解决办法】升级至12.1.0官网版本解决解密问题；中文版7月双周包已验证无解密问题，英文版已申请加入8月双周包出包流程，下周升级至12.1.0双周包英文版
问题11：3645幅0.5米分辨率DOM影像需按盟市行政区裁剪并切地图瓦片，试过镶嵌数据集（打开卡死看不到影像）和导入udbx（转坐标耗时过长），寻求高效方案
11.3.0
【解决办法】使用镶嵌数据集按基础比例尺切瓦片：切瓦片时勾选基础比例尺，上层小比例尺瓦片按该级自动合成，全幅即可正常显示；着急时可多机并行切分。注意：未建概视图时产品会控制影像显示比例尺，只要确保最大层级影像显示正常即可。另可对地图设置目标坐标系并开启动态投影后保存地图切瓦片
问题12：使用转换插件后数据源不带坐标参数导致无法生成矢量切片（数据集与地图有WGS84墨卡托3857投影）
11.3.0
【问题原因 】12.0版本存在问题：转换工具用完后数据源不带坐标参数，导致矢量切片生成失败。 【解决办法】升级到12.1版本，重新给数据源指定坐标系（数据集、地图不变），即可正常生成矢量切片。
问题13：DEM数据存在异常负值（极值-10033到295，周围一圈大范围-9999），咨询如何处理这些异常值。
12.0.0
【问题原因 】正常DEM除新疆部分盆地外应大于0，-9999和-10033均为无效异常值。【解决办法】使用iDesktopX的栅格代数运算（功能类似ArcGIS栅格计算器）剔除-9999和-10033等异常负值，或直接裁剪掉错误区域；
问题14：桌面端对线要素执行打断功能时打断失败，本地UDBX数据源打断正常，连接数据库（Kingbase V9）打断后保存不成功，需定位是产品功能问题还是数据库环境问题。
12.0.0
【问题原因 】查看组件日志发现写入数据集失败是因为event_id这个字段违反了唯一约束
【解决办法】event_id字段的唯一约束业务上无法修改，绕行办法：将要打断的线event_id值设置null，再打断，打断后再去修改这两条的值为唯一值
问题15：使用嵌套 scp（MongoDB）算子处理倾斜数据前，需确认入库的 S3M 版本与 MongoDB 版本是否满足算子要求，避免嵌套失败。
12.0.0
【问题原因 】嵌套 scp（MongoDB）算子仅支持 S3M 3.01 版本的数据，S3M 版本过高或过低都会导致嵌套无法执行。【解决办法】核对客户环境为 S3M 3.01、MongoDB 4.4.5，均在算子支持范围内，可直接执行嵌套 scp 操作。
问题16：同一套数据在 2025X 桌面端加载三维瓦片时模型之间位置关系发生错位，而在 11i .NET 组件中加载显示正常；模型为轨枕、扣件（点外挂方式）与钢轨+底座（普通方式）三个 S3M 3.0 图层，均通过 SCP 配置加载。
12.0.0
【问题原因 】新版本与老版本地球椭球不一致（老版本为圆球、与 Cesium 一致，新版本为椭球），椭球差异导致模型错位。【解决办法】生成S3M缓存按 3.01版本 重新生成。
问题17：客户咨询点外挂缓存是否只能使用 4326 坐标系，反馈桌面端按 4490 坐标系生成点外挂缓存后，输出的 SCP 文件中坐标系仍为 4326，需确认坐标系设置方式。
12.0.0
【问题原因 】点外挂缓存坐标系取决于生成缓存时的坐标系参数设置，未显式指定时按默认 4326 输出。【解决办法】点外挂缓存支持 4490 坐标系，需在生成时显式指定坐标系；组件开发中可使用 Point3DLinkModelCacheBuilder 的 PrjCoordSysType 属性设置目标坐标系后重新生成缓存，SCP 中的坐标系即与设置一致。
问题18：客户制作打印图纸时，希望在同一布局中实现主图与局部放大图（局部大样）效果，即在同一张图纸上以不同比例尺展示局部细节，询问 iDesktopX 布局是否支持及具体实现方式。
11.3.0
【解决办法】布局中通过多个地图控件并分别设置不同比例尺实现局部大样：同一幅地图可重复插入多个地图控件，选中控件后使用"锁定地图"功能对地图进行缩放和平移，调整各自的显示范围；若局部图样式不同，则单独制作地图后放入布局。布局绘制地图操作参考 https://help.supermap.com/iDesktopX/zh/tutorial/Layout/DrawingMapElements/Map.html
问题19：桌面端能否直接处理从 OSM 下载的 pbf 文件，希望读取其中数据并存入 udbx 数据源
11.3.0
【问题原因 】桌面端不支持直接解析 pbf 格式，需先转换为 OSM 格式再导入。【解决办法】参考 OSM 数据转换方法（https://blog.csdn.net/m0_60794512/article/details/149632019）将 pbf 转为 .osm 文件，再通过桌面端直接导入并另存为 udbx 数据源。
问题20：客户加载 BIM 模型后需要提取模型的底面轮廓，用于裁剪地形，询问在超图桌面产品中如何从三维 BIM 模型里把底面提取为可用的矢量面数据。
11.3.0
【问题原因 】BIM 模型以三维瓦片方式加载到场景，没有现成的底面矢量数据可直接使用。【解决办法】选中底面模型另存为模型数据集，将新数据集添加到场景后对数据集生成投影面，得到二维面；再通过【数据】-【类型转换】-【二维面转三维面】输入高程，得到高度统一的三维面，即可用于裁剪地形。
问题21：客户使用提取出的面裁剪地形时没有反应，多次远程后仍未生效，怀疑面数据高程或操作方式不正确，需要确认裁剪地形的正确操作步骤。
11.3.0
【问题原因 】用于裁剪的面为手动绘制范围或缺少高程信息，Z 值与地形不匹配，导致裁剪操作无效果。【解决办法】导入由模型底面转换得到的二维面后，在 Z 值处输入真实高度；或使用【数据】-【类型转换】-【二维面转三维面】，输入统一高程生成三维面后再执行地形裁剪。
问题22：客户直接打开 tif 影像数据后，投影转换功能按钮呈灰色不可用；且按常规方式导入影像耗时较长，客户希望在不长时间导入的前提下完成投影转换并用于切图。
11.3.0
【问题原因 】直接打开的影像文件为只读文件，不属于数据源中的数据集，因此投影转换等编辑功能置灰；导入耗时与影像数据量及金字塔创建有关。【解决办法】将影像导入数据源后再执行投影转换；若最终用于切图，可创建镶嵌数据集，选择 tif 并设置目标坐标系，影像会自动投影转换到目标坐标系，再对镶嵌数据集切图。
问题23：桌面端导入 DWG 文件时，DWG 中各图形的属性信息能否完整保存到数据集中
11.3.0
【问题原因 】DWG 属性存储于扩展记录中，导入时未勾选对应选项会导致属性丢失。【解决办法】在导入 DWG 的导入设置中勾选导入扩展记录等选项，即可完整保留图形属性，各选项含义见 http://help.supermap.work/iDesktopX/tutorial/DataProcessing/DataConversion/ImportCAD.html
问题24：PostGIS 标准图形库由 QGIS 入库，桌面端打开后能看到表结构但无数据，需确认 iServer 能否连接并发布地图服务
12.0.0
【问题原因 】以 PostgreSQL 数据源方式连接时无法识别 QGIS 入库的矢量数据，改用 PostGIS 数据源类型即可正常读取；跨版本时桌面端版本高于 iServer 也会导致工作空间不可用。【解决办法】在桌面端以 PostGIS 数据源类型连接该库后发布地图服务；桌面端版本需与 iServer 一致或低于 iServer。
问题25：确认桌面端向 PostgreSQL 库入库时 smid、smuserid 是否必然生成，geometry 字段名是否默认变为 smgeometry
12.0.0
【问题原因 】sm 开头的字段均为 SuperMap 系统字段，创建数据源时由平台默认生成。【解决办法】无需手工建字段，入库后 smid、smuserid 为必需系统字段，geometry 字段默认命名为 smgeometry。
问题26：在桌面端打开影像图层后，地图列表为空，导致导出地图功能不可用，无法完成影像导出。
12.0.0
【问题原因 】当前地图尚未保存，地图列表中无地图记录，导出功能缺少可选对象。【解决办法】点击地图窗口的关闭按钮，在弹出对话框中输入地图名称并保存，保存后地图出现在地图列表中，即可正常选择并导出地图模板。
三、SuperMap iClient3D for WebGL
问题1：iServer是否支持二次开发实现从3DTiles数据上提取模型高度，寻求可行的技术实现方案
11.3.0
【解决办法】可在前端直接获取3DTiles高度：let p = SuperMap3D.Cartesian3.fromDegrees(longitude,latitude,0)，let a = viewer.scene.clampToHeight§，通过clampToHeight接口贴地取高程实现
问题2：有两个地图服务，期望一个地图仅在1-11层显示，另外一个地图仅在12-18层显示。
11.3.0
【解决办法】推荐监听相机高度变化，根据相机高度值来更新两个图层的显示隐藏。
问题3：使用12.1版本生成S3M 3.01数据，用客户端12.1的Cesium加载存在位置偏移，寻求支持排查
12.0.0
【解决办法 】Cesium默认是圆球，生成的3.01是椭球数据，需要在初始化的时候设置一下椭球体参数：var obj = 6378137.0, 6378137.0, 6356752.3142451793;
Cesium.Ellipsoid.WGS84 = Object.freeze(new Cesium.Ellipsoid(obj0, obj1, obj2));
问题4：客户引入mars3d-cesium后按插件方案接入时报错，咨询引入mars3d-cesium是否会有问题
12.0.0
【解决办法】SuperMap 支持原生Cesium，不支持mars3d-cesium。
问题5：按官方范例获取知识图谱中实体图斑图形时，点击查询按钮无任何效果，控制台也无任何反应
11.3.0
【解决办法】查询范例存在问题已更新，请访问最新查询范例：https://www.supermapol.com/webgl/Cesium/examples/webgl/editor.html#getFeatureBySQL
问题6：iClient3D for WebGL 中添加可视域分析后移除，多次添加移除正常，但点击切换其他 entity（model、billboard）加载后，拖动场景卡死，无报错
11.3.0
【解决办法】产品包bug，更新最新webgl产品包链接https://pan.baidu.com/s/1K0cUNgRBAG4OIWsgPJXLCw?pwd=6655
问题7：矢量点数据直接切s3mb缓存并发布三维服务后，前端能否将这些点替换为自定义图片图标，需明确可行实现方式。
11.3.0
【解决办法】s3mb缓存方式不支持在前端替换点图标，建议改用前端entity方式实现自定义图片图标。
问题8：倾斜数据嵌套后在 iDesktopX 中可正常打开，但发布三维服务后前端预览看不到模型，需判定是数据问题还是客户端版本问题。
12.0.0
【问题原因 】嵌套结果与数据本身正常，问题由前端三维客户端包版本过低导致，旧版本加载嵌套后的 scp 三维服务无法显示模型。【解决办法】改用国地信最新版本客户端包加载该服务即可正常显示；加载时通过 viewer.scene.addS3MTilesLayerByScp 指定服务 config 地址，并用 camera.setView 定位到数据所在经纬度与高度范围，现场使用新包验证加载正常。
问题9：三维模型缓存服务发布后，前端三维场景相机拉近至近景观察时，模型局部构件纹理贴图丢失、构件呈无纹理黑色显示，远景浏览贴图正常，客户怀疑与 LOD 设置有关。
11.3.0
【问题原因 】模型数据集法线未正确计算，近景渲染时光照计算异常导致贴图发黑失真。【解决办法】对模型数据集重新计算法线，再重新生成三维缓存并发布服务，近景构件贴图恢复正常显示。
四、SuperMap iObjects Java
问题1：多个obj模型导入到一个模型数据集，导入后只剩一个模型，其他导入失败，寻求其他实现方式
11.3.0
【解决办法】iDesktopX导入验证正常前提下，组件端使用ModelConvertor.fromFile迭代逐个导入实现，或直接用iDesktopX导入后获取数据集
问题2：11.1 版本 iObjects Java 是否支持从 openGauss + Yukon 数据库中指定 schema 模式读写数据集，例如 p_io_schema_test 库下存在多个 schema，希望通过组件获取 p_c_cl001 这个 schema 下的数据，并咨询能否同时使用多个 schema。
11.1.0
【问题原因 】openGauss + Yukon 多 schema 场景下，组件读写的数据位置由 Yukon 扩展插件所指定的 schema 决定。【解决办法】Yukon 扩展插件指定到哪个 schema，iObjects Java 就在哪个 schema 下读写数据；未安装 Yukon 扩展的 schema 仅支持读取数据，不支持写入，参考博客：https://blog.csdn.net/Causal321/article/details/130988578 。
问题3：基于 Ubuntu 24.04 基础镜像将 iObjects Java 12.1.1 制作成容器镜像，启动时报库文件相关错误，疑似缺少依赖
12.0.0
【解决办法 】修正库文件指向，此方案适用于镜像已经构建完成，或在 Dockerfile 中执行 RUN 指令时进行修复。
一、确认系统标准库路径：在镜像内执行以下命令，确认系统正确版本的 liblzma.so.5 位置。
find /usr/lib -name "liblzma.so.5" 2>/dev/null
（通常路径为 /usr/lib/x86_64-linux-gnu/liblzma.so.5）
二、备份并替换冲突文件：将 /usr/local/lib/ 下的旧库文件备份，并创建一个指向系统标准库的符号链接。
1. 备份旧库文件（将其移出库搜索路径）
sudo mv /usr/local/lib/liblzma.so.5 /usr/local/lib/liblzma.so.5.bak
2. 创建指向系统标准库的软链接
sudo ln -s /usr/lib/x86_64-linux-gnu/liblzma.so.5 /usr/local/lib/liblzma.so.5
这个操作既解决了 dpkg-deb 的报错，也保留了原文件以备不时之需
三、在 Dockerfile 中的写法：如果希望在构建镜像时自动修复，可以在安装 akusbsd 包的 RUN 指令前加入以下命令：
RUN mv /usr/local/lib/liblzma.so.5 /usr/local/lib/liblzma.so.5.bak || true
&& ln -sf /usr/lib/x86_64-linux-gnu/liblzma.so.5 /usr/local/lib/liblzma.so.5
问题4：客户使用 iObjects Java 12.1.0 执行邻近点分析，设置邻近距离 5 千米后运行结果与原始点完全一致、无任何变化（图中红点为分析结果、绿点为原始点），需确认是参数设置问题还是功能异常
12.0.0
【问题原因】数据源存在问题【解决方案】数据导出后重新导入其他数据源可正常执行
问题5：scp_check 库在 PostGIS 数据源下可打开但无法创建要素、无法复制数据，12.0.0 桌面端连接 PostGIS 时选不到 schema，仅 12.1.0 可正常打开。
12.0.0
【问题原因 】数据中心产品使用的 iObjects 为12.0.0，该版本 PostGIS 数据源尚未支持指定模式；由于 PostGIS 扩展安装在 public 模式，无法使用 scp_check 模式下的数据源，故表现为可选库但无法建要素。【解决办法】推荐将数据中心 iObjects 升级至12.1.0，使 iDesktopX、iObjects、iServer 大版本统一；或提交申请单将 PostGIS 扩展迁移到 scp_check 模式后验证（需确认该库其他模式未使用 PostGIS 扩展）；若验证不通过，回退绕行方案新建的数据源系统表和序列，改用 iDesktopX 12.0.0 新建 Yukon 数据源。
问题6：使用 ImportSettingSHP 导入 SHP 时需设置源文件字符集，cpg 文件标识为 ISO-8859-1，但 Charset 类中无该编码，需确认应选用的字符集
11.3.0
【问题原因 】ISO-8859-1 属西欧编码，若属性中含中文按该编码解析必然乱码，且 cpg 文件标识的编码本身可能不准确。【解决办法】属性含中文时直接按 GBK（GB18030）设置源文件字符集；确认为纯英文数据时可选用 WINDOWS1252 编码。
五、SuperMap iDesktop
问题1：配准功能设置同名点导出到配准文件后再导入，参考地图里面点的位置发生整体偏移，咨询原因及解决方法
11.3.0
【解决办法】导出配准信息文件后，后续使用快速配准，导入配准信息文件即可，不需要再进行编辑
问题2：客户使用通过运行报告（report）生成的正式许可，启动桌面端提示未检测到许可，许可中心显示授权信息异常；与许可绑定的 .id 文件已丢失且无法找回，咨询该 id 文件能否重建以恢复授权
11.3.0
【问题原因 】许可为基于运行报告生成的正式许可，与之绑定的 .id 文件丢失导致桌面端无法识别授权，且该文件不支持重建。【解决办法】需重新收集机器运行报告并重新申请正式许可，授权下发后替换许可文件即可正常使用；后续生成报告时注意保留同目录下的 .id 文件
问题3：客户按指导生成运行报告后，发现输出文件并非以 .id 为扩展名，怀疑生成的文件格式不正确、无法用于许可申请，咨询该现象的原因及正确处理方法
11.3.0
【问题原因 】运行报告已正常生成 .id 文件，只是操作系统默认隐藏已知文件类型的扩展名，导致文件显示为无后缀。【解决办法】右键查看文件属性确认文件类型为 id，或在资源管理器中开启"文件扩展名"显示后即可正常识别并用于许可申请
问题4：制作的专题图含单值专题图与统计柱状图两个图层、使用同一数据集，坐标系为4527；在地图窗口将地图动态投影到4490后，单值专题图显示正常但统计柱状图不显示。
10.2.1
【问题原因 】10i 桌面版本在动态投影场景下对统计类专题图（柱状图）的渲染存在缺陷，同一数据集的单值专题图不受影响，因此表现为柱状图丢失。【解决办法】将工程升级到 11i 后重新保存地图，柱状图即可随动态投影正常显示；官方建议直接升级到 12i，或先用高版本保存工作空间、再用当前版本打开执行后续步骤。10i 已停止维护，需持续使用请申请 iDesktopX 12.1.1 许可。
六、SuperMap iManager
问题1：咨询云套件（iManager）是否涉及披露的两个安全漏洞，以及服务器上PHP相关进程是否可以强制关闭
11.3.0
【问题原因 】iManager的数据库Web客户端工具使用的就是PHP服务。【解决办法】可通过指令 kubectl get pod -A 并筛选 php、client 相关Pod查询，再通过 kubectl scale --replicas=0 deployment（指定deployment名称）-n（指定命名空间）关闭这些开启的客户端工具即可
问题2：11.1版本iManager for K8s的云套件替换12.1.1.0版本云套件镜像后，服务一直显示启动中，咨询原因
11.1.0
【问题原因 】GIS云套件11版本不兼容12版本镜像，所以无法直接升级。
【解决办法】如有使用12i版本需求，建议升级完整iManager for k8s和GIS云套件。（升级教程：https://help.supermap.com/iManager_K8S/zh/GettingStarted/UpgradePackage.htm）
问题3：咨询如采用矢量瓦片自动更新方案，iManager for GIS（imgr）云原生专业版本是否支持该功能
11.3.0
【解决办法】SuperMap iServer提供的矢量瓦片自动更新功能可实现后端数据更新后前端矢量瓦片服务自动刷新（定期检测数据变化、清除/刷新MVT旧缓存、过期瓦片按新数据重新出图），云原生环境可基于该功能实现矢量瓦片自动更新，参考：https://ima.qq.com/share/#/knowledge-base-chat/YR48x72Wr
问题4：iManager 发布点标签专题图时，地图范围外接口异常报错，且长标签被截断，属于升级阻断类缺陷，需在客户现场验证修复效果。
12.0.0
【问题原因 】旧版本 iManager 在生成点标签专题图时未对超出地图范围的点与超长标签做边界处理，导致接口异常且标签截断。【解决办法】使用修复后的版本（缺陷 ISVJ-12528 已修复），在现场发布点标签专题图验证，地图范围外点不再触发接口异常，长标签完整显示，验证通过。
七、SuperMap 其他
问题1：咨询超图文件许可是否存在类似序列号的标识信息，用于许可管理与登记
11.3.0
【问题原因 】文件许可机制与序列号授权方式不同。【解决办法】文件许可没有独立序列号，其绑定的是机器硬件信息（如MAC地址、机器名、机器码等），按硬件绑定方式管理即可
问题2：产品界面中的logo、文字、水印如何去除，是否需要搞正式授权并重新出安装包
11.3.0
【解决办法】水印的去除需要正式授权；其他的logo与文字有对应的去除方式，可参考超图支持博客（https://blog.csdn.net/supermapsupport/article/details/144744640）中整理的方法操作，无需重新出安装包
问题3：磁盘碎文件读写测试脚本在内网及国产操作系统上执行报错，提示缺少组件或无执行权限，无法获取缓存盘性能数据
11.3.0
【问题原因 】该磁盘只允许读不允许写
【解决办法】执行的时候添加参数--no-write。只测读不测写. 如:python disk.py --disks "/opt" --no-write --processes 4 --duration-min 10
八、SuperMap iObjects .NET
问题1：客户反馈组件中带 schema 的对象写法存在多种形式，除此前沟通的 @ 符号形式外还有以小数点分隔的写法，与原有结论不一致，需研发确认产品实际支持的语法形式。
12.0.0
【问题原因 】12i 版本扩展了 schema 表达式的解析能力，除 @ 符号形式外同时支持以小数点分隔的写法，因此与此前仅支持 @ 形式的结论不一致。【解决办法】经研发确认，12i 已同时支持小数点和 @ 符号两种写法，客户可按现有配置继续使用，无需改造已有 schema 表达式。
问题2：客户按时间条件查询数据查不到结果，使用 DBeaver 客户端执行相同 SQL 可以查到数据，怀疑组件查询逻辑或时间参数处理存在问题。
12.0.0
【问题原因 】数据库中日期时间以 UTC 时间存储，与客户代码使用的本地时间相差 8 小时，按本地时间构造的查询条件落在实际数据时间范围之外，导致查询结果为空。【解决办法】查询前将时间条件转换为 UTC 时间（本地时间减 8 小时）后再传入查询接口，或统一数据库时间字段与业务代码的时区口径，避免时差导致条件不命中。
九、SuperMap Unreal Engine
问题1：已用建筑面数据拉伸白模并做基础贴图，客户希望模型效果接近游戏引擎渲染效果，咨询实现思路
11.3.0
【解决办法】建议采用SuperMap Hi-Fi 3D SDK for Unreal插件，将白模数据导入Unreal Engine中进行材质美化与渲染，可获得接近游戏引擎的高保真模型效果。
十、SuperMap iClient for JavaScript
问题1：单值专题图发布工作空间地图服务后，咨询前端能否单独控制每个专题值的显示与隐藏
11.3.0
【解决办法】前端可以通过属性过滤来创建临时图层，从而单独控制单值专题图中每个值的显示与隐藏
十一、SuperMap iMobile Android
问题1：咨询超图移动GIS产品是否支持安卓16（Android 16）操作系统
11.3.0
【解决办法】确认移动产品支持安卓16系统，可直接在Android 16设备上部署使用
十二、SuperMap iPortal
问题1：服务器重启后 iPortal（11.3.0 Linux 部署）停留在许可检查界面无法进入，排查发现主机名与申请许可时不一致（原为 localhost.localdomain），修改主机名并重启后仍读取不到许可
11.3.0
【问题原因 】服务器主机名被变更，导致绑定机器信息的本地文件许可校验失败
【解决办法】将主机名修改为申请许可的主机名，重启服务器后能正常获取到许可
十三、SuperMap ClientX
问题1：咨询SuperMap ClientX目前是否有技术文档，官网上未找到相关文档入口
12.1.0
【解决办法】下载supermap-clientx-2026-beta资源包，运行包内index.html示例即可查看ClientX的示例与用法说明。
平台产品线高频问题集合汇总表
https://lexiangla.com/teams/k100048/docs/ad346a06e82511ee87832effa0562057