故障排除
BigLedger常见问题的快速解决方案和综合问题解决指南。本节帮助您快速解决问题并重新开始高效工作。
快速问题解决
最常见问题
本综合故障排除指南解决最常见的BigLedger问题，包含具体错误代码、分步解决方案和预防措施。
登录和访问问题
- 无法登录：密码重置、账户状态、浏览器问题
- 功能缺失：权限问题、applet可用性
- 性能缓慢：浏览器优化、网络问题
- 会话超时：安全设置、浏览器配置
数据录入问题
- 无法保存记录：验证错误、必填字段
- 下拉选项缺失：主数据设置、权限
- 导入失败：数据格式、映射错误
- 重复记录：数据验证、合并程序
交易问题
- 订单处理错误：工作流程问题、审批链
- 定价问题：价格方案配置、客户设置
- 库存差异：库存调整、位置问题
- 报告错误：数据访问、参数设置
分步故障排除
1. 识别问题
- 记录症状 - 确切发生了什么？
- 重现问题 - 您能让它再次发生吗？
- 检查时间 - 何时开始出现？
- 收集上下文 - 您试图完成什么？
2. 收集信息
- 错误消息 - 复制确切的错误文本和代码
- 截图 - 问题的视觉证据
- 用户账户详情 - 权限和角色信息
- 系统环境 - 浏览器、设备、网络信息
3. 尝试基本解决方案
- 刷新/重新加载 - 简单的浏览器刷新
- 清除缓存 - 浏览器缓存和cookie
- 不同浏览器 - 用另一个浏览器测试
- 检查权限 - 验证访问权限
4. 高级诊断
- 检查系统状态 - 系统是否正常运行？
- 审查最近更改 - 最近有什么变化？
- 用不同数据测试 - 是否特定于数据？
- 查阅文档 - 审查相关用户指南
BigLedger错误代码和解决方案
系统错误代码（ERR-SYS-XXXX）
ERR-SYS-0001：访问被拒绝
- 原因：用户缺少请求操作的必要权限
- 技术详情：模块或功能级别的权限验证失败
- 即时解决方案：
- 联系系统管理员
- 在用户管理中验证用户角色分配
- 检查模块特定权限
- 长期预防：
- 实施定期权限审计（季度）
- 一致使用基于角色的访问控制（RBAC）
- 为每个业务功能记录权限要求
ERR-SYS-0002：会话过期
- 原因：由于不活动导致的安全超时（默认：60分钟）
- 技术详情：会话令牌已超过最大生命周期
- 即时解决方案：
- 完全退出并重新登录
- 清除浏览器缓存和cookie
- 禁用敏感数据的浏览器自动保存
- 配置选项：
会话设置（管理 > 安全）： • 超时期间：30-480分钟 • 空闲警告：到期前5分钟 • 并发会话：允许/限制 • 记住我：启用/禁用
ERR-SYS-0003：数据库连接失败
- 原因：网络中断或数据库服务器不可用
- 技术详情：连接池耗尽或数据库维护
- 即时解决方案：
- 等待2-3分钟后重试
- 在status.bigledger.com检查系统状态
- 如果问题持续>5分钟联系支持
- 预防：监控数据库健康和连接池使用
数据验证错误（ERR-VAL-XXXX）
ERR-VAL-1001：必填字段缺失
- 原因：数据录入期间强制字段留空
- 字段类型：客户代码、产品名称、交易金额等
- 解决步骤：
- 查看表单中红色星号（*）标记的字段
- 填写所有必需信息
- 验证数据格式（日期、数字、邮箱）
- 重新保存记录
- 常见缺失字段：
客户记录：姓名、税号、联系信息 产品记录：代码、名称、计量单位 交易：日期、金额、账户代码
ERR-VAL-1002：无效数据格式
- 原因：数据不符合预期格式或业务规则
- 常见场景：
- 无效邮箱格式（缺少@符号）
- 错误日期格式（需要DD/MM/YYYY）
- 无效电话号码格式（+60-XXX-XXXXXXX）
- 税号格式不符合马来西亚标准
- 解决方案：
- 检查字段格式提示和示例
- 在可用的地方使用格式验证器
- 从验证来源复制粘贴
交易错误（ERR-TXN-XXXX）
ERR-TXN-2001：库存不足
- 原因：试图销售/分配超过可用库存的数量
- 技术详情：实时库存检查失败
- 详细解决方案：
- 检查当前库存水平：库存 > 库存查询
- 验证库存位置和可用性
- 考虑这些选项：
- 将数量减少到可用库存
- 从其他位置转移库存
- 为剩余数量创建后续订单
- 如果库存计数不正确则更新库存
- 库存管理最佳实践：
• 为所有活跃项目设置再订购点 • 每日监控库存水平 • 实施自动再订购通知 • 定期循环盘点确保准确性
ERR-TXN-2002：找不到价格
- 原因：项目/客户组合没有配置有效价格
- 价格层次检查：
- 客户特定定价
- 客户组定价
- 促销定价
- 标准价格表
- 基础成本价格
- 配置步骤：
- 导航到销售 > 价格管理
- 按客户类型设置价格方案
- 配置促销定价期间
- 为新产品设置默认价格
- 用样本交易测试定价
马来西亚合规错误（ERR-MYS-XXXX）
ERR-MYS-4001：SST计算错误
- 原因：销售和服务税计算或配置问题
- SST规则：
- 标准税率：6%（大多数商品和服务）
- 零税率：0%（出口、免税商品）
- 免税：不适用SST
- 配置检查：
- 产品设置：验证SST代码分配
- 客户设置：检查SST免税状态
- 税务设置：审查SST计算规则
- 税率更新：确保加载当前SST税率
ERR-MYS-4002：电子发票生成失败
- 原因：MyInvois集成错误或验证失败
- LHDN电子发票要求：
强制字段： • 供应商TIN（税务识别号） • 买方TIN（用于B2B交易） • 发票日期和时间 • 唯一发票号码 • 产品/服务描述 • SST详情 - 验证错误：
- TIN格式：必须是有效的马来西亚TIN格式
- 日期/时间：必须在MyInvois提交时间框架内
- 货币：仅MYR和批准的外币
- 文档类型：必须匹配LHDN批准的类型
集成错误（ERR-INT-XXXX）
ERR-INT-3001：同步失败 - 银行
- 原因：银行集成连接失败或认证过期
- 支持的特定银行：马来亚银行、CIMB、大众银行、RHB、丰隆银行
- 故障排除步骤：
- 检查凭据：在财务 > 银行集成中验证银行登录详情
- 测试连接：使用"测试连接"按钮
- 刷新令牌：如果使用OAuth重新认证
- 网络检查：确保防火墙允许银行连接
- 银行状态：检查银行系统是否因维护而停机
ERR-INT-3002：电子商务同步错误
- 原因：与在线商店平台的连接问题
- 支持的平台：Shopee、Lazada、WooCommerce、Magento、Shopify
- 错误子类型：
3002-A：认证失败 3002-B：产品目录同步失败 3002-C：订单下载错误 3002-D：库存更新失败 3002-E：定价同步错误 - 平台特定解决方案：
- Shopee：检查卖家中心的API密钥和秘钥
- Lazada：验证卖家中心的应用授权
- WooCommerce：测试REST API凭据
- Shopify：刷新私人应用权限
⚠️
安全第一：在进行任何系统更改来解决问题之前，确保您有适当的备份并了解更改的影响。
浏览器特定问题
Chrome问题
- 缓存问题：清除浏览数据，重置Chrome设置
- 扩展冲突：禁用扩展，在隐身模式下测试
- 内存问题：关闭未使用的标签页，重启浏览器
Firefox问题
- 安全设置：为BigLedger调整安全偏好
- 插件冲突：在禁用插件的情况下测试
- Cookie设置：确保为BigLedger启用cookie
Safari问题
- JavaScript设置：为BigLedger域启用JavaScript
- 隐私设置：为业务应用调整隐私设置
- 缓存问题：清除BigLedger的网站数据
移动浏览器问题
- 响应式设计：复杂屏幕使用横向模式
- 触摸界面：使用适当的导航手势
- 数据连接：确保稳定的互联网连接
性能优化
系统性能
详细性能优化
识别性能瓶颈
系统性能仪表板
- 导航到管理 > 系统健康
- 监控CPU、内存和数据库性能
- 检查活跃用户会话和并发进程
- 审查系统日志的错误模式
用户体验监控
- 跟踪不同模块的页面加载时间
- 监控报告生成速度
- 分析用户会话持续时间和超时
- 识别经常访问的缓慢功能
浏览器端性能优化
推荐的浏览器设置：
✓ 启用JavaScript和cookie
✓ 禁用不必要的浏览器扩展
✓ 每周清除缓存
✓ 更新到最新浏览器版本
✓ 允许BigLedger域的弹出窗口
✓ 设置足够的内存分配网络优化
- 带宽要求：最佳性能最少10 Mbps
- 延迟考虑：到BigLedger服务器<100ms延迟
- 连接稳定性：有线连接比WiFi优先
- VPN影响：测试有/无VPN的性能
- 防火墙配置：将BigLedger域和端口列入白名单
数据库性能调优
- 查询优化：使用适当的过滤器和日期范围
- 索引管理：确保在经常查询的字段上有适当索引
- 数据归档：归档旧数据以提高查询性能
- 并发用户：监控数据库连接限制
- 维护窗口：安排定期数据库维护
客户端优化
- 浏览器维护：定期清除缓存，更新浏览器
- 网络优化：稳定的互联网连接，避免高峰时段
- 设备性能：足够的RAM，关闭不必要的应用程序
- 屏幕分辨率：为BigLedger优化显示设置
服务器端因素
- 高峰使用时间：了解系统负载模式
- 数据量：大报告和查询影响性能
- 集成负载：多个同时集成影响速度
- 维护窗口：计划维护影响可用性
数据性能
- 查询优化：使用适当的过滤器和日期范围
- 报告效率：限制大报告的数据范围
- 批处理：将类似操作分组在一起
- 归档策略：归档旧数据以提高性能
升级程序
何时升级
- 安全事件：安全漏洞的即时升级
- 系统中断：当系统完全不可用时
- 数据损坏：任何疑似数据完整性问题
- 关键业务影响：影响核心业务运营的问题
如何升级
- 记录问题：全面的问题描述
- 收集证据：截图、错误消息、日志
- 评估影响：业务影响和紧急程度
- 联系适当支持：使用正确的支持渠道
- 跟进：监控解决和沟通状态
自助服务资源
知识库
- FAQ部分 - 常见问题答案
- 视频教程 - 分步视觉指南
- 用户论坛 - 社区驱动的支持
- 文档 - 综合用户指南
诊断工具
- 系统健康检查 - 内置系统诊断
- 连接测试 - 网络和集成测试
- 权限检查器 - 验证用户访问权限
- 性能监控 - 系统性能指标
效率提示：保持故障排除日志以跟踪重复问题及其解决方案。这建立了您的专业知识并帮助识别系统改进机会。
预防策略
主动维护
- 定期更新：保持浏览器和系统更新
- 培训计划：持续的用户教育和培训
- 系统监控：定期健康检查和性能监控
- 数据备份：维护当前备份和恢复程序
最佳实践
- 文档：保持程序文档化和最新
- 测试：在生产前在暂存环境中测试更改
- 沟通：通知用户系统更改和更新
- 监控：为关键系统指标设置警报
获得帮助
支持渠道
- 📧 邮箱支持：vincent@bigledger.com 技术问题
- 💬 快速聊天：Telegram @leehongfay 即时问题
- 📞 电话支持：工作时间内可用
- 🌐 支持门户：在线工单系统和知识库
提供的支持信息
- 问题描述：问题的清楚解释
- 重现步骤：如何重新创建问题
- 错误消息：任何错误消息的确切文本
- 用户信息：账户详情和权限
- 系统详情：浏览器、设备和网络信息
- 业务影响：问题如何影响您的运营
响应时间期望
- 关键问题：1-2小时响应时间
- 高优先级：4-8小时响应时间
- 正常问题：1-2个工作日响应时间
- 增强请求：在月度规划周期中审查
解决成功：通过适当的问题识别和使用合适的资源和支持渠道，大多数用户问题都可以快速解决。