常见问题
Q:cms2.0.3 之前的版本无法启动，没有报错，一直在显示加载中
A:电脑之前使用过 2.0.3 及以上版本，切换了使用”SQLServer 数据库”配置，该配置存储在电脑系统文件，2.0.3 以下版本不支持该数据库，导致无法启动；解决方法：重新打开 2.0.3 及以上版本切换回 Mysql 数据库
Q:若修改变量信息，如修改变量名，数据表和报警对应的变量无法继续归档
A:配置未同步，需要重启数据和报警服务
Q:表达式配置二进制变量，若等式填写 1 和 0，则表达式不生效
A:二进制变量若填写等式，需要填写 true 或 false
Q:启动服务后闪退，报客户端 GPU 异常
A:电脑双显卡且软件安装路径是中文，将安装路径改为纯英文路径
Q:未更换电脑，序列号变化
A:更新网卡导致 mac 地址变化，序列号会重新生成
Q:基座打了插件后，修改端口号，无法启动软件
A:信息化插件此设置都不生效，如需修改端口，需要手动去 host\appsettings.json 中修改 Urls 的值
Q:SIOT启动后打印"Please set the operating system character code to Chinese GBK code!"
A:修改电脑系统默认编码，使用GBK编码
Q:MC3E协议连接PLC成功，变量点采集成功，写入变量失败
A:修改设备通道配置->高级配置->禁用独立链路
Q:通过S7协议与西门子1500通讯连接失败，日志显示PLC拒绝该功能
A: PLC访问权限设置错误
1.访问级别设置选择“完全访问权限”或“HMI访问权限”
2.连接机制，勾选“PUT/GET通信访问”
3.下发PLC的硬件配置到实体PLC
Q:MODBUS协议数据读取异常，与PLC值不符
A:调整对应变量类型的字节排序
Q:远程运维共享网卡失败，无法ping通目标网段
A:共享网卡出现异常，需手动重置物理网卡和虚拟网卡的共享状态
Q：系统不断提示变量服务重连
A：检查下已配置的IO变量，是否存在变量写入了NaN、+∞、-∞等非法值，该情况将会导致变量服务不断重连，需要将该变量值修改为常规数值或文本
Q：程序服务没有退出，托盘程序不显示
A：第三方UI库bug，该问题出现的前置条件，是文件资源管理器出现异常重启，属于极少数情况下才会出现，待第三方库处理后可同步该处理；若用户有该问题出现，引导重启下电脑，可以解决问题
Q: Error:ERR_INVALID_HTTP_RESPONSE(-370)loagding‘http://127.0.0.1:18000/?baseURL=http://127.0.0.1:18000’
A: 这通常是由于部分安全软件限制了内置浏览器内核的网络通信所致。CMS的界面依赖于本地网络服务（127.0.0.1），当此通信被阻止时，便会出现此错误。您可以尝试临时使用其他浏览器（如Edge或Chrome）直接访问 http://127.0.0.1:18000 作为临时解决方案，并检查您的安全软件设置，将CMS相关进程添加到信任列表。
Q: 启动软件后不见服务窗口，但任务管理器却有CMS.Supervisor进程
A: 这是一个已知的兼容性问题，主要影响CMS 2.17.1版本与部分旧版Windows 10系统的兼容性。我们已在后续版本中修复了此问题，请您将CMS升级至2.18或更高版本以解决。
Q: 开发版工程管理打开工程报错：无效工程文件:SQLite Error 1:'no such table: project infos'.x
A: 该错误 no such table: project infos 表明您尝试打开的工程文件已损坏或不完整（例如，文件大小为0KB）。这通常是因为文件在复制或传输过程中出错。请确保您打开的是一个有效的、完整的工程文件，而不是快捷方式或损坏的副本。
Q: 打开工程时报错："An error occurred while saving the entity changes. See the inner exception for details."
A: 此错误通常表示您的工程文件被设置为了“只读”属性，导致程序无法写入更改。这种情况常见于通过某些即时通讯软件（如微信）传输文件后，文件属性被自动修改。请右键点击您的工程文件，选择“属性”，在常规选项卡中取消勾选“只读”属性，然后重新打开工程。
Q: 打开工程时报错："SQLite Error 11:'database disk image is malformed'."
A: 这个错误 database disk image is malformed 意味着工程文件内的数据库结构已损坏。这通常是由于在软件保存工程时发生非正常关机、强制退出程序或存储设备问题导致的。唯一的解决方案是从您最近的有效备份中恢复或重新导入工程文件。
Q: 台达PLC编程软件ISPSoft使用远程运维无法选择SVPN的虚拟网卡
A: 这是由于旧版的台达通讯管理软件（COMMGR）与我们 远程运维功能（SVPN）的虚拟网卡不兼容所致。经测试，台达COMMGR 1.11及以下版本存在此问题。请将您的COMMGR软件升级至1.15或更高版本即可解决。
Q: 打开工程时报错：SQLite Error 26:'file is not a database'.
A: 该错误提示表明，您尝试打开的不是一个有效的工程文件，而很可能是一个指向工程文件的快捷方式。请检查您打开的文件，并确保您操作的是工程文件本身，而不是它的快捷方式。
Q: 云萃VPN使用虚拟网口连接时提示"虚拟网卡被占用"
A: 此问题是由于云萃VPN的虚拟网卡驱动与西门子PLC仿真软件的虚拟网卡驱动发生冲突。两者不能同时激活。若安装或启动VPN时遇到此提示，请先完全退出西门子仿真软件，然后在Windows的“网络连接”中禁用西门子相关的虚拟网卡，再重新尝试安装或启动云萃VPN。
Q: 软件无法启动，日志体现无法连接SIOT，任务管理器中的SIOT进程不断启动并自动退出
A: SIOT服务依赖于系统的GBK编码环境。如果您的Windows系统开启了“Beta: 使用 Unicode UTF-8 提供全球语言支持”选项，将导致SIOT无法正常启动。请在Windows的“设置” > “时间和语言” > “语言和区域” > “管理语言设置” > “更改系统区域设置”中，取消勾选该UTF-8 Beta选项，然后重启电脑。
Q: 运行版客户端运行时报“404”错误
A: 客户端报“404”错误意味着它无法连接到本地的服务端API。常见原因有：1. 服务端程序未能成功启动或在客户端启动时意外退出（例如，由于服务器内 存不足）。2. 存在多个客户端实例被配置为开机自启，造成冲突。请检查服务端是否正常运行，排查系统资源占用情况，并确保只有一个客户端实例在运行或被配置为自启动。
Q: CMS系统时间和Windows系统不一样
A: CMS在启动时会获取并缓存当前的系统时区信息。如果您在CMS运行期间更改了Windows系统的时区，CMS内部的时间显示不会自动同步。要解决此问题，只需重新启动CMS服务即可，它会在启动时重新加载最新的时区设置。
Q: Table '..._runtime.password_history' doesn't exist
A: 此问题通常发生在进行大版本跨度的工程升级时，由于部分数据库升级脚本未能成功执行导致。要修复此问题，您需 要手动清理旧的运行时数据并重建缓存（请注意：此操作将清除历史配方和趋势分析数据，操作前请备份工程）。步骤如下：1. 使用数据库管理工具打开工程文件，删除runtime库中的formula, formula_apply_record, curve_analysis这三个表。2. 删除软件安装目录下的host/data/projects/cache.json文件。3. 重新启动CMS。
Q: 如何确认互联的MQTT功能启用后工作正常？
A: 默认情况下，为优化性能，MQTT互联功能的详细日志是关闭的。要启用它进行调试，请按以下步骤操作：1. 打开软件安装目录下的 host/appsettings.json 配置文件。2. 找到 UpCloudLogLevel 这个键，并将其值从 0 修改为 7。3. 保存文件并重启CMS。之后，您就可以在 host\sdklog\[日期]\cloud_sdk_[日期时间].log 路径下找到详细的MQTT通信日志了。
Q: CMS启动服务异常，提示“端口被占用”
A: 提示“端口被占用”意味着CMS需要使用的网络端口（如18000等）已被其他程序占用。这可能是由于上一次CMS未能完全退出导致进程残留，或是其他软件占 用了该端口。请打开Windows任务管理器，检查并手动结束所有名为CMS.Supervisor.exe, Cms.Host.exe等CMS相关的进程，然后重新启动软件。
Q: 设置了开机自启但软件没有自动启动
A: CMS的开机自启功能依赖于Windows的“命令处理程序”（Command Processor）。如果此系统组件在启动项中被禁用，将导致CMS自启失败。请打开任务管理器，切换到“启动”选项卡，找到名为“Windows Command Processor”或类似的项目，并确保其状态为“已启用”。
Q: 部分电脑CMS服务监控-关于-在线更新异常（无法获取最新版本的在线更新）
A: 无法获取在线更新信息通常是由于我们的更新服务器暂时不可用或正在维护。如果您遇到此问题，请稍后再试。如果问题 持续存在，请通过我们的官方渠道（如官方论坛、技术支持邮箱）联系我们以获取帮助。
Q: 安装CMS时，报错”Error sending data:(12007)无法解析服务器的名称和地址“
A: 这个错误（无法解析服务器的名称和地址）表明安装程序在尝试连接网络下载所需组件时失败。这通常发生在离线环境中。我们的安装包分为主程序和离线驱动包，请确保在安装主程序之前，您已经运行并成功安装了我们提供的离线驱动包。
Q: 报错：“Unknown column '...' in 'field list'”
A: 此SQL错误通常与BI（商业智能）组件相关。它表示BI组件在查询数据时，尝试访问一个不存在的字段（列）。这很可能是因为该BI组件关联的某个维度或指标的配置存在问题（例如，字段名有误、乱码，或源数据表结构已变更）。请检查并修正相关BI组件的数据源和字段配置。
Q: 报错："Duplicate entry '...' for key '...'"
A: 该错误表示您正在尝试插入或更新的数据与表中的现有数据在一个被定义为“唯一”的字段上（如主键或唯一索引）产生了重复。请检查您准备导入的数据文件（如Excel表），确保其中没有重复的键值。在导入前，您也可以选择先清空目标数据表，以避免冲突。
Q: CMS Vision自启动失败，监控托盘显示为空白
A: 这通常是由于系统中存在多个冲突的CMS开机自启动配置项导致的。您可以通过编辑Windows注册表来解决此问题（操作前建议您了解注册表编辑风险）：1. 按 Win+R，输入 regedit 并回车打开注册表编辑器。2. 导航到路径 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run。3. 在右侧窗口中，查找所有与CMS相关的启动项，保留一个正确的，并删除其余多余的项。4. 重启电脑。
Q: CMSVision启动时提示“服务端程序被终止”
A: 此提示意味着服务端在加载工程时失败。一个常见的原因是工程文件被设置为了“只读”属性，导致程序无法正常加载。请右键点击您的工程文件，选择“属性”，并取消勾选“只读”选项后重试。
Q: 服务无法运行，host日志查询报错“[Error] ... Connect siot failed”
A: 错误“Connect siot failed”表示核心的SIOT服务未能启动。这是因为SIOT服务在首次运行时会根据您当前的硬件（主要是网卡）信息生成一个授权文件。如果您的网络适配器发生了变化（例如，安装/卸载了虚拟网卡、禁用了物理网卡等），会导致授权验证失败。请按以下步骤重置授权：1. 导航到CMS安装目录下的siot子目录。2. 删除其中的License文件夹。3. 手动双击运行该目录下的SIOT.exe程序，它会自动重新生成新的授权文件。4. 重新启动CMS服务。
Q: 历史归档服务启动报错“unauthorized access”
A: 此“未授权访问”错误通常发生在历史归档服务（基于InfluxDB）上，表示配置文件中的密码与数据库的实际密码不匹配。这可能是因为您在此电脑上曾独立安装或使用过InfluxDB。解决方案有两个：1. 保留旧数据：如果您记得之前的InfluxDB密码，可以编辑CMS安装目录下的host/appsettings.json文件，找到InfluxDB的连接字符串并更新为正确的密码。2. 重置数据库（将丢失所有历史归档数据）：如果您不需要旧数据，可以前往您的C盘用户目录（例如 C:\Users\YourUsername），删除名为 .influxdbv2 的隐藏文件夹，然后重启CMS，系统会自动以正确的密码重新初始化数据库。
Q: OPCUA协议中组数据下发时提示“下发失败”
A: 为了防止误操作，OPC UA驱动中的“组数据下发”功能默认是关闭的。如果您需要使用此功能批量写入数据，请进入该OPC UA通道的“高级配置”界面，找到并勾选（启用）【组数据下发】选项即可。
Q: 之前正常使用的环境，提示Mysql连接失败
A: 在正常运行后突然出现MySQL连接失败，通常是由于非正常关机（如断电）导致MySQL数据库文件损坏。您可以尝试重装数据库来修复。为防止未来再次发生此问题，我们强烈建议您提前优化MySQL的配置以增强数据写入的安全性：停止MySQL服务后，编辑其my.ini配置文件，在[mysqld]节下添加 innodb_doublewrite = 1 和 innodb_flush_log_at_trx_commit = 1 等参数，以确保数据在断电前的持久化。
Q: CMS SIOT服务断开，如何排查？
A: SIOT服务意外断开，可以遵循以下思路进行排查：1. 检查日志完整性：查看siot/presslog目录下的日志文件，确认服务中断的具体时间点。2. 检查服务退出指令：在中断时间点附近的SIOT日志中，搜索关键词Exit request。如果找到，请同步核对CMS Host日志，查看是否有变量服务 stop的记录，以确认是否为CMS主动停止。3. 排查外部干扰：如果日志中没有主动退出的记录，请检查是否有其他程序或人为操作（如关闭命令行窗口）终止了siot.exe或siot watchdog进程。4. 检查系统事件：查看Windows事件查看器中的系统和应用程序日志，寻找在服务中断时间点附近有无相关的错误或关机记录。
Q: CMS变量服务定时断开
A: 变量服务定时断开是我们的授权校验机制的表现。这通常由以下两种情况之一引起：1. 您工程中使用的某个设备驱动（协议）未经授权。2. 您连接的设备总数超过了您购买的授权点数。请检查您的授权信息，确保使用的驱动和设备数量均在授权范围内。
Q: 变量服务单个外部通道报错：Sequence contains no matching element
A: 这个.NET错误 Sequence contains no matching element 在我们的软件中通常意味着，当变量服务尝试加载一个外部设备通道时，找不到该通道所依赖的协议驱动。请检查该通道的配置，确认它使用的是哪种协议，并在当前电脑上安装相应的驱动程序。
Q: 电脑包括系统全部卡死，无法运行
A: 系统级别的完全卡死通常源于深层的软件兼容性或硬件问题。可能的原因有：1. 系统兼容性：请确保您的操作系统版本与我们推荐的兼容版本（如 Windows 10 IOT LTSC/21H2）一致。2. 硬件故障：内存条故障（如存在坏块）是导致随机卡死的常见硬件原因。您可以尝试重装一个兼容的纯净操作系统来排除软件问题，或使用内存检 测工具、替换内存条来排查硬件问题。
Q: 电脑蓝屏
A: 电脑蓝屏的原因多种多样，但如果与运行高负载程序相关，可能与电源管理有关。部分节能模式的电源计划可能会导致硬件供电不稳。您可以尝试将Windows的电源计划设置为“高性能”模式，以确保CPU和其他硬件获得持续稳定的电力供应，这有时可以解决特定场景下的蓝屏问题。