产品文档已发布
RAILWISE-TSM 常见问题与故障排查
TSM平台使用过程中的常见问题汇总、故障排查流程与技术支持渠道
产品文档
RAILWISE-TSM 常见问题与故障排查
Section titled “RAILWISE-TSM 常见问题与故障排查”适用版本: TSM v3.2+ 阅读对象: 所有 TSM 用户（工程师、管理员、现场人员） 更新频率: 每月更新
本文档汇总了 RAILWISE-TSM 平台在实际使用过程中最常见的技术问题、操作疑问和故障场景，提供症状识别 → 根因分析 → 解决方案的完整排查路径。如按本文档无法解决，请通过文末渠道联系技术支持。
2. 快速诊断流程
Section titled “2. 快速诊断流程”遇到问题时，建议按以下顺序排查：
┌─────────────────────────────────────────┐│ Step 1: 确认问题范围 ││ ├── 仅影响单个测点？ → 检查仪器/测点配置 ││ ├── 仅影响单个项目？ → 检查项目设置 ││ └── 影响整个系统？ → 检查服务状态 │├─────────────────────────────────────────┤│ Step 2: 查看系统状态 ││ ├── 系统状态页: https://tsm.railwise.cn/status ││ └── 健康检查: railwise-tsm health check │├─────────────────────────────────────────┤│ Step 3: 查看日志 ││ ├── Web端: 浏览器 F12 → Console/Network ││ ├── 管理后台: 系统管理 → 日志查询 ││ └── 服务器: docker-compose logs <服务名> │├─────────────────────────────────────────┤│ Step 4: 查阅本文档对应章节 ││ └── 按问题分类查找解决方案 │├─────────────────────────────────────────┤│ Step 5: 联系技术支持 ││ └── 提供: 项目ID、问题描述、截图、日志 │└─────────────────────────────────────────┘3. 登录与账号问题
Section titled “3. 登录与账号问题”3.1 无法登录系统
Section titled “3.1 无法登录系统”| 症状 | 可能原因 | 解决方案 |
|---|---|---|
| 提示“账号或密码错误” | 密码输入错误 | 点击“忘记密码”重置 |
| 提示“账号已被锁定” | 连续输错密码5次 | 等待15分钟自动解锁，或联系管理员 |
| 提示“账号已过期” | 账号有效期到期 | 联系组织管理员续期 |
| 页面白屏/加载失败 | 浏览器缓存问题 | Ctrl+F5 强制刷新，或清除缓存 |
| SSO 登录跳转失败 | 企业微信/钉钉配置变更 | 联系IT管理员检查 SSO 配置 |
3.2 权限不足提示
Section titled “3.2 权限不足提示”错误信息: "您没有权限执行此操作"
排查步骤：1. 确认当前账号角色（我的 → 账号信息）2. 确认是否已分配至目标项目3. 检查操作是否在角色权限范围内（参见权限矩阵）4. 如确需权限，联系项目经理或组织管理员4. 数据采集问题
Section titled “4. 数据采集问题”4.1 全站仪无法连接
Section titled “4.1 全站仪无法连接”症状: 仪器状态显示"离线"或"通信异常"
排查清单:□ 仪器电源是否开启□ 仪器网络连接是否正常（ping 仪器IP）□ 网关设备（串口服务器/无线模块）是否在线□ 仪器IP地址是否与配置一致□ 仪器端口是否被防火墙拦截□ 仪器固件版本是否兼容
诊断命令: railwise-tsm instrument diagnose --id TS-01
常见解决方案:1. 重启仪器电源（等待30秒后重新连接）2. 检查网线/WiFi连接，必要时重新配置网络3. 在系统管理后台重新配置仪器通信参数4. 更新仪器固件至兼容版本- 全站仪建议使用静态IP，避免DHCP分配变化导致失联
- 跨网段通信需配置路由或NAT
- 无线传输场景建议使用工业级4G/5G路由器
4.2 数据采集成功但数据异常
Section titled “4.2 数据采集成功但数据异常”| 异常现象 | 可能原因 | 解决方案 |
|---|---|---|
| 数据全部为0 | 仪器未正确照准棱镜 | 检查仪器对中、整平、照准状态 |
| 数据跳变巨大 | 棱镜被遮挡或移动 | 检查现场，重新初始化测量 |
| 数据不变化 | 仪器进入待机模式 | 调整仪器休眠策略 |
| 坐标值明显错误 | 坐标系配置错误 | 核对测站坐标、后视方向 |
| 高程系统性偏差 | 大气折光/温度影响 | 增加气象改正或调整观测时段 |
4.3 采集频率不达标
Section titled “4.3 采集频率不达标”症状: 设定每15分钟采集一次，实际间隔不稳定
排查步骤:1. 检查仪器测量周期设置 - 全站仪搜索+测量时间通常 30-120秒/点 - 测点数量 × 单点测量时间 ≈ 总周期
2. 检查网络延迟 - 高延迟网络（>500ms）会影响指令响应
3. 检查并发任务 - 同一仪器是否被多个工作流同时调度
4. 优化建议 - 减少单次测量测点数量 - 使用"快速测量"模式（精度适当降低） - 增加仪器数量分担负载5. 预警与报警问题
Section titled “5. 预警与报警问题”5.1 报警未触发
Section titled “5.1 报警未触发”症状: 监测值已超限，但系统未产生报警
排查清单:□ 预警规则是否已启用（规则状态: 启用/停用）□ 测点是否正确关联了预警规则□ 报警阈值设置是否正确（注意单位统一为mm）□ 是否处于"消警期"（消警后需重新达到阈值才报警）□ 是否设置了防抖时间（debounce）□ 数据质量是否通过校验（异常数据不参与报警判断）
调试方法: 在预警规则页面点击"测试规则"，输入测试值验证触发逻辑5.2 报警未收到通知
Section titled “5.2 报警未收到通知”| 症状 | 排查项 | 解决方案 |
|---|---|---|
| 系统有报警记录但未收到短信 | 手机号是否正确 | 检查个人资料中的手机号 |
| 短信通道余额 | 联系管理员充值 | |
| 短信模板审核状态 | 确认模板已通过运营商审核 | |
| 未收到邮件 | 邮箱地址是否正确 | 检查并验证邮箱 |
| 邮件进入垃圾箱 | 添加发件人至白名单 | |
| 邮件服务器配置 | 联系管理员检查 SMTP 配置 | |
| 未收到企业微信/钉钉 | 账号绑定状态 | 重新绑定企业账号 |
| 应用权限 | 确认企业应用有发送消息权限 |
当多个渠道同时配置时，系统按以下优先级发送：
- 短信（最高优先级，确保及时送达）
- 企业微信/钉钉（即时性较好）
- 邮件（适合详细报告）
红色报警默认触发全部渠道，黄色报警可配置仅发送邮件。
5.3 误报/频繁报警
Section titled “5.3 误报/频繁报警”症状: 报警频繁触发，实际现场无异常
可能原因与解决方案:1. 阈值设置过于严格 → 与设计单位确认合理的报警阈值 → 参考历史数据设置统计阈值（均值+3σ）
2. 数据噪声导致波动 → 增加平滑处理（移动平均） → 调整报警判断为"连续N次超限"而非单次
3. 仪器精度不足 → 检查仪器标定状态 → 考虑更换更高精度仪器
4. 温度/气象影响 → 增加气象传感器数据参与修正 → 设置时段排除（如避开正午高温时段）6. 数据与报告问题
Section titled “6. 数据与报告问题”6.1 历史数据缺失
Section titled “6.1 历史数据缺失”症状: 某时段数据查询为空
排查步骤:1. 检查该时段仪器是否在线 → 仪器状态历史 → 查看离线记录
2. 检查是否有数据清理任务 → 系统管理 → 数据归档策略
3. 检查数据质量校验记录 → 部分数据可能因质量不合格被标记为无效
4. 检查数据库状态 → 磁盘空间是否充足 → 数据库连接是否异常
数据恢复:- 如已归档，可从归档存储中恢复（联系管理员）- 如仪器本地有存储，可手动补录6.2 报告生成失败
Section titled “6.2 报告生成失败”| 错误提示 | 原因 | 解决方案 |
|---|---|---|
| “模板加载失败” | 报告模板文件损坏 | 重新上传模板或恢复默认模板 |
| “数据不足无法生成” | 选择时段内无数据 | 扩大时间范围或检查数据完整性 |
| “生成超时” | 数据量过大 | 缩小时间范围，或分时段生成 |
| “PDF 渲染失败” | 字体缺失 | 安装中文字体包 |
| “图表渲染失败” | 浏览器兼容问题 | 更换 Chrome/Edge 浏览器 |
6.3 数据导出异常
Section titled “6.3 数据导出异常”症状: 导出文件内容为空或格式错误
排查:1. 检查筛选条件是否过于严格2. 检查导出格式是否与数据类型匹配3. 大数据量导出建议使用异步任务4. Excel 导出时确保无特殊字符（如换行符）
Excel 打开乱码处理:- 使用记事本打开 CSV，另存为 UTF-8 BOM 格式- 或在 Excel 中使用"数据 → 从文本/CSV 导入"功能7. 移动端问题
Section titled “7. 移动端问题”7.1 APP 无法同步数据
Section titled “7.1 APP 无法同步数据”症状: 点击同步后一直转圈或提示失败
排查步骤:1. 检查网络连接 → 切换 WiFi / 移动数据测试 → 访问 https://tsm.railwise.cn 确认服务端可达
2. 检查存储空间 → 手机设置 → 存储 → 确保有 500MB 以上可用空间
3. 检查账号权限 → 确认账号有数据录入权限
4. 强制同步 → 我的 → 离线数据 → 强制同步全部
5. 仍失败则: → 导出本地数据备份（我的 → 数据导出） → 清除 APP 缓存或重新安装 → 重新登录后导入备份数据7.2 定位不准确
Section titled “7.2 定位不准确”| 场景 | 原因 | 解决方案 |
|---|---|---|
| 野外定位偏差大 | GPS信号弱 | 移至开阔地带，等待定位精度 < 10m |
| 地下空间无定位 | GPS信号被遮挡 | 使用蓝牙信标或RFID辅助定位 |
| 定位漂移 | 多径效应 | 使用差分GPS或RTK定位 |
| 定位权限被拒 | APP未获取位置权限 | 手机设置 → 应用权限 → 开启位置权限 |
7.3 蓝牙水准仪连接问题
Section titled “7.3 蓝牙水准仪连接问题”症状: 无法连接徕卡/拓普康数字水准仪
排查:1. 确认手机蓝牙已开启2. 确认水准仪蓝牙模式已激活3. 在手机蓝牙设置中配对水准仪4. 在 TSM APP 设置中选择正确的仪器型号5. 部分型号需输入配对码（通常为 0000 或 1234）
支持型号:- 徕卡: LS10, LS15, DNA03- 拓普康: DL-502, DL-503- 天宝: DiNi 0.3, DiNi 0.7
不支持型号请联系技术支持评估适配可行性。8. 性能与系统问题
Section titled “8. 性能与系统问题”8.1 页面加载缓慢
Section titled “8.1 页面加载缓慢”症状: Web 端页面打开慢、图表加载卡顿
排查与优化:1. 网络检查 ping tsm.railwise.cn → 延迟 > 100ms 建议联系网络管理员优化
2. 浏览器优化 → 关闭不必要的浏览器插件 → 限制同时打开的标签页数量 → 使用 Chrome/Edge 最新版本
3. 数据量优化 → 查询时间范围不要过大（建议 ≤ 30天） → 减少同时显示的测点数量 → 使用"聚合视图"替代"原始数据视图"
4. 服务器性能 → 联系管理员检查服务器负载 → 考虑增加服务器资源配置8.2 系统报错代码
Section titled “8.2 系统报错代码”| 错误代码 | 含义 | 解决方案 |
|---|---|---|
TSM-E001 |
数据库连接失败 | 检查数据库服务状态 |
TSM-E002 |
仪器通信超时 | 检查仪器网络连接 |
TSM-E003 |
数据校验失败 | 检查数据格式和范围 |
TSM-E004 |
权限不足 | 联系管理员分配权限 |
TSM-E005 |
存储空间不足 | 清理历史文件或扩容存储 |
TSM-E006 |
并发操作冲突 | 刷新页面后重试 |
TSM-E007 |
外部服务调用失败 | 检查第三方服务状态 |
TSM-E008 |
许可证过期 | 联系商务续费 |
TSM-E009 |
数据加密失败 | 检查加密密钥配置 |
TSM-E010 |
工作流执行失败 | 查看工作流日志排查 |
9. 数据安全与备份
Section titled “9. 数据安全与备份”9.1 误删除数据恢复
Section titled “9.1 误删除数据恢复”场景: 误删除测点或项目数据
恢复流程:1. 立即停止所有写入操作（暂停采集）2. 联系系统管理员3. 管理员从备份中恢复数据 → 恢复至删除前最近的备份点 → 导出被删除的数据 → 重新导入生产环境4. 验证数据完整性5. 恢复采集
注意:- 备份恢复会丢失备份点之后的新增数据- 建议定期验证备份可用性9.2 账号安全问题
Section titled “9.2 账号安全问题”| 场景 | 处理措施 |
|---|---|
| 怀疑账号被盗 | 立即修改密码，启用双因素认证 |
| 收到异常登录提醒 | 检查登录IP，如非本人操作则强制下线并改密 |
| API密钥泄露 | 立即在后台吊销旧密钥，生成新密钥 |
| 员工离职 | 管理员及时禁用账号，转移数据归属 |
10. 联系技术支持
Section titled “10. 联系技术支持”10.1 自助渠道
Section titled “10.1 自助渠道”| 渠道 | 地址/方式 | 响应时间 |
|---|---|---|
| 在线帮助中心 | https://help.railwise.cn | 即时 |
| 视频教程 | https://help.railwise.cn/video | 即时 |
| 社区论坛 | https://community.railwise.cn | 24h |
| 智能客服 | TSM 右下角“在线客服” | 即时 |
10.2 人工技术支持
Section titled “10.2 人工技术支持”提交工单前请准备以下信息：
必填信息:1. 项目ID（如: proj-2024-nb-001）2. 问题描述（清晰、具体）3. 复现步骤（如何操作会出现该问题）4. 截图/录屏（如有界面问题）5. 浏览器/APP版本号6. 发生时间（精确到分钟）
可选但有助于排查:- 浏览器 Console 错误日志（F12 → Console）- 网络请求截图（F12 → Network）- 服务器日志（管理员提供）| 支持渠道 | 联系方式 | 服务时间 |
|---|---|---|
| 工单系统 | https://support.railwise.cn | 7×24h |
| 技术支持热线 | 400-XXX-XXXX | 工作日 8:30-18:00 |
| 企业微信 | 添加 “RailWise技术支持” | 工作日 8:30-22:00 |
| 紧急支持 | emergency@railwise.cn | 7×24h（红色报警相关） |