先用 TIA Portal 打开项目，确认版本、路径和权限都正常。
文档手册
HQ Scan 现场排障
HQ Scan 问题通常来自 TIA 环境、Openness 权限、扫描范围、规则过滤或导出字段。先确认环境，再看扫描结果。
开始扫描前先确认环境
HQ Scan 不负责运行采集，它负责从工程项目中整理点位。环境和权限不正常时，后面的结果都不可靠。
当前 Windows 用户必须具备 Openness 权限；状态异常时先修复权限。
大项目优先从小范围开始，先选一个 PLC、一个 DB 或一组表确认规则，再扩大扫描范围。
TIA Portal、项目或 Openness 权限异常
环境不正常时，扫描结果可能为空、缺字段或直接失败。
确认本机 TIA Portal 版本能打开当前项目。高版本项目不要用低版本 TIA 读取。
确认当前用户在 Siemens Openness 相关用户组中；修复后重新登录 Windows 再启动 HQ Scan。
项目不要放在只读目录、临时目录或网络不稳定路径。路径过长或包含异常字符时，先复制到本地短路径。
输入 IP 后在线扫描没有点位
在线扫描不依赖本机博图，但依赖 PLC 在线协议暴露的内容。先区分端口可达、OPC UA 可浏览和可导出点位三件事。
输入 `opc.tcp://PLC-IP:4840` 或 PLC IP 后，先确认 4840 可达。可达只说明网络通，仍需 PLC 端启用 OPC UA Server 并允许对应变量被浏览。
102 可达不代表能导出符号点位。没有 TIA 项目或 OPC UA 节点时，优化 DB 的符号名、注释、类型和偏移都不能可靠枚举。
在线扫描以 DB 点位为主要整理范围。输入、输出和存储区变量如需交付，应先在工程侧形成明确映射或按独立清单处理。
确认 OPC UA 已启用、证书或账号策略通过、防火墙放行、目标 DB 或变量允许 HMI/OPC UA/外部访问。在线扫描以 PLC 明确开放的节点作为点位来源。
正式交付优先使用离线 TIA 项目扫描；没有项目时，先在 PLC 侧把要交付的变量通过 OPC UA 明确开放，再使用在线扫描。
修复权限后仍然读取失败
Openness 权限通常需要重新登录 Windows 或重启 TIA/HQ Scan 才会完全生效。
把当前用户加入 Siemens Openness 相关用户组后，注销并重新登录 Windows，再打开 TIA Portal 和 HQ Scan。
项目来自压缩包、共享目录或只读目录时，先复制到本机可写路径再扫描。
扫描结果异常时，先确认 TIA Portal 主版本和项目版本一致，不要跨大版本读取。
扫描为空、很慢或结果数量异常
先缩小扫描范围，再看项目树、PLC 和 DB 选择是否正确。
确认左侧项目树选中了实际 PLC、DB 或表；不要只选项目根节点就期待所有结果都正确。
先看它是否在项目树选中范围内、是否能被当前用户通过 Openness 读取、是否被规则中心排除，以及内部成员是否能展开成支持的标量点。
先按 PLC、DB 或项目树分支缩小范围；20 万级以上 Tag 项目建议分批扫描和导出，避免巨大结构化 DB 把时间拖长。
离线看到的是 TIA 项目元数据，在线看到的是 PLC OPC UA Server 当前开放出来的节点。OPC UA 开放范围、DB 访问权限、项目树范围、规则过滤和支持类型都会让数量不同，不能简单要求两者完全一致。
先用保留规则圈定主集合，再用排除规则处理诊断、临时和中间变量。
10 万 / 20 万 Tag 项目扫描或导出很慢
大项目不要一次全量验证所有规则；先分 PLC、分 DB、分地址段扫描，再合并结果。
先按 PLC 或 DB 分批扫描，确认规则正确后再扩大范围。20 万 Tag 项目应避免一次性全量导出反复试错。
备份 DB、历史 DB、装载内存 DB、数组或 UDT 较多的 DB，通常适合在规则稳定后单独复核。先用业务 DB 和表验证范围、字段和规则，再扩展到特殊 DB。
先用保留规则缩小主集合，再用排除规则清理诊断、临时、中间变量，减少后续人工复核量。
导出前抽样检查符号地址、绝对地址和数据类型。字段异常时先调整范围或规则，再进行系统导入。
符号地址、绝对地址或数据类型不符合预期
导入 HQControl 前，必须先确认符号地址、绝对地址和数据类型的字段含义。
结果表和导出文件以符号地址作为点位主键。人工复核、规则匹配和后续导入都应优先看符号地址、数据类型和地址信息。
符号地址用于 HQControl S7 符号模式或 OPC UA 符号访问。工程树包装层和容器名称仅用于上下文复核，不作为运行访问地址。
绝对地址用于 S7 102 或 Modbus 等地址链路，必须能明确 DB、字节偏移、位偏移和数据类型。优化 DB 未暴露稳定偏移时，以符号地址为准。
数据类型要和 PLC 侧真实类型一致。导入前重点检查 BOOL、INT、DINT、REAL、LREAL、STRING 等标量类型。
符号地址、编码重复或字段规范不符合导入要求
导入前先确认符号地址、编码唯一性和字段规范，避免进入运行系统后再补救。
符号地址和导入编码应避免控制字符、不可见字符、异常标点或路径符号。发现此类内容时，先在规则或工程侧整理。
同一设备下 Tag 编码必须唯一。重复时先按规则生成稳定编码，再人工确认。
UDT、数组和结构体应按可复核的标量成员整理。需要独立采集的值，建议在 PLC 工程中整理为明确标量。
导出文件无法导入或字段对应不上
先确认导出模板和目标系统地址模式，再决定使用符号地址模板还是绝对地址模板。
先在 HQControl 建好对应设备编码，Excel 里的 `deviceCode` 必须和设备编码完全一致，大小写也一致。
导出规范主要覆盖可解析 DB 标量成员，以及可归一为 DB 点位的工程内容。UDT、数组和结构体容器用于描述上下文；能展开到支持标量的子成员会作为点位导出。
核心字段是 `deviceCode`、`code`、`symbolicAddress` 和 `dataType`。导入前先确认编码唯一、符号地址可访问、数据类型与 PLC 侧一致。
核心字段是设备、地址区、DB、偏移、位、访问类型、数据类型。导入失败时先看字段是否为空或冲突。
如果 DB 本身不在扫描范围、读取失败、复杂结构无法稳定展开、访问权限不满足或被规则中心排除，它不会进入导出文件。先回到 HQ Scan 结果表确认是否生成了可导出的点位行。