故障排查
启动和连接问题
| 症状 | 可能原因 | 处理 |
|---|---|---|
| 启动闪退或无反应 | .NET 10 SDK 未安装 | 安装 .NET 10 SDK（注意是 SDK，不是 Runtime） |
| 启动时提示端口被占用 | 9210 或 8443 端口已有其他程序 | 关闭占用端口的程序，或修改 appsettings.json 换端口 |
浏览器无法访问 http://localhost:9210 | NewEngine 未成功启动、防火墙阻拦 | 检查控制台是否有监听成功日志；确认防火墙放行 |
| 局域网其他设备无法访问 | 防火墙、IP 地址变化 | 检查本机 IP，系统防火墙放行 9210/8443 |
| HTTPS 页面提示不安全 | 自签名证书 | 浏览器「高级」→「继续前往」。生产环境建议配置正式证书 |
| 浏览器页面空白或报错 | 前端文件不完整 | 确认 ClientApp/dist 目录存在且完整 |
应用状态问题
| 症状 | 可能原因 | 处理 |
|---|---|---|
| 应用中心 显示 加载错误 | CustomScripts.dll 缺失/过期、对象类型不存在、插件缺失 | 进编辑器 → 修复源码 → 点 Build → 重启应用 |
| 启动后变 error 状态 | 设备对象初始化失败、连接超时 | 检查设备连接参数，确认设备在线 |
| 一直停在 Starting... | 设备连接建立中卡住 | 检查网络和防火墙，确认设备 IP/端口正确 |
| 停止按钮不生效 | 应用正在执行长时操作 | 等待操作完成或强制关闭进程后重启 |
页面问题
| 症状 | 可能原因 | 处理 |
|---|---|---|
| 运行页打不开（404） | 页面文件不存在或路径错误 | 检查页面是否被删除、Page ID 是否正确 |
| 运行页显示 401 未授权 | 应用用户未登录或角色不足 | 用 currentUser 控件登录，或检查页面 requiredRoles |
| 控件不显示 | 控件 requiredRoles 不匹配 | 检查控件权限设置，或在编辑模式确认控件存在 |
| 控件显示但点击无反应 | action 绑定的方法不存在或报错 | 检查属性面板 action 绑定，查看浏览器控制台报错 |
| 表格数据不更新 | 数据源表达式错误或变量未初始化 | 检查 rows 表达式是否正确，变量是否有值 |
| 表达式显示空白 | 引用的变量/控件/对象不存在 | 编辑器 LSP 会标红提示，修正引用 |
| Model3D 模型不显示 | 模型文件路径错误、格式不支持 | 确认模型文件在 assets/ 下且为 GLB/GLTF 格式 |
流程图问题
| 症状 | 可能原因 | 处理 |
|---|---|---|
| Graph 构建失败 | 节点端口类型不匹配、缺少必需输入 | 打开 Graph → 查看 Problems 面板错误 → 修正连线/参数 |
| 修改 Graph 后运行效果不变 | 只保存了 Graph 没有 Build | 保存后点 Build，再重启应用 |
| Graph 运行时报错 | 引用的对象已被删除或改名 | 检查对象树，重新选择目标对象 |
| 节点参数选择器无效 | 变量或查询已被删除 | 打开节点属性，重新选择 |
| Wait Until 超时后不执行 Timeout | Timeout 分支未连接 | 连接 Timeout 出口到处理节点 |
设备连接问题
| 症状 | 可能原因 | 处理 |
|---|---|---|
| 设备对象显示连接失败 | IP/端口配置错误 | 检查对象属性面板的连接参数；ping 目标设备 |
| 通信超时 | 网络不通、设备离线、防火墙 | 检查网线、IP 同网段、系统防火墙 |
| IO 点位读不到值 | IO 映射配置错误 | 检查 PulsarIoBank 的映射配置 |
| 轴不动 | 驱动器未就绪、急停触发、限位信号 | 检查驱动器状态、确认急停释放、检查限位信号 |
| 轴位置偏差 | 回零未完成或参数错误 | 先执行回零，检查电子齿轮比和脉冲当量设置 |
AI 问题
| 症状 | 可能原因 | 处理 |
|---|---|---|
| AI 面板无响应 | Qixin AI 配置未保存 | 系统设置 → AI 设置 → 配置 API key 并保存 |
| 模型列表加载失败 | API key 无效或网络不通 | 检查 key 是否正确，确认能访问 token.qixin.ai |
| AI 生成的代码编译失败 | AI 基于旧上下文 | 用 @ 引用当前文件，让 AI 重新读取最新状态 |
其他
| 症状 | 可能原因 | 处理 |
|---|---|---|
| 文件保存失败 | 磁盘满、文件被占用 | 检查磁盘空间和文件权限 |
| Git 面板操作失败 | 凭据过期、远程不可达 | 检查网络、凭据或重置 Git 配置 |
| ZIP 导入后 App 显示 加载错误 | DLL 和当前环境不匹配 | 进编辑器 Build 一次，生成匹配本机的 DLL |
| 回到 应用中心 时弹出确认 | 有未保存的修改 | 根据需要保存或放弃 |