3. ERP连接故障分类

ERP系统作为企业核心业务的中枢神经，其连接稳定性直接关系到财务数据录入、审批流运转与现金流预测的实时性。本章将连接故障归纳为四大类：网络层故障、应用层故障、数据库连接池耗尽以及认证与权限问题。每一类故障的排查路径、影响范围与修复手段均有显著差异，财务数据分析师与运维人员需建立清晰的分类认知，才能在故障发生时快速定位根因。

3.1 故障分类总览

下表从故障层次、典型表现、影响范围与排查优先级四个维度，对四类连接故障进行横向对比：

3.2 网络层故障

网络层故障是ERP连接故障中最基础也最容易被忽视的一类。当财务人员无法打开ERP客户端或报表页面时，首先应排除网络连通性问题。常见原因包括：

• 物理链路中断：网线松动、交换机端口故障、光纤损坏。
• 路由配置错误：静态路由缺失、动态路由协议收敛异常。
• 防火墙策略拦截：ERP应用端口（如 443、1433、8080）被意外阻断。
• DNS解析失败：ERP服务器域名无法正确解析为IP地址。

排查网络层故障时，建议遵循“从近到远、从底层到上层”的原则：先检查本机网络适配器状态与IP配置，再使用 ping 测试网关与目标服务器，最后用 telnet 或 Test-NetConnection 验证端口可达性。

# 测试网络连通性
ping erp.company.com

# 测试端口是否开放（Linux）
telnet erp.company.com 443

# 测试端口是否开放（Windows PowerShell）
Test-NetConnection erp.company.com -Port 443

# 追踪路由路径
tracert erp.company.com

3.3 应用层故障

应用层故障发生在ERP应用服务器或中间件层面，通常表现为服务进程崩溃、应用配置错误、依赖服务不可用等。这类故障的排查难度高于网络层故障，因为其症状往往与网络层故障相似（如“连接超时”），但根因却在应用代码或配置中。

典型应用层故障场景包括：

• 应用服务未启动或崩溃：Tomcat、WebLogic、IIS 等容器进程异常退出。
• 负载均衡配置错误：健康检查路径错误、后端服务器权重异常。
• SSL/TLS证书问题：证书过期、域名不匹配、中间证书缺失。
• API网关限流或熔断：超出调用频率限制导致请求被拒绝。

排查应用层故障时，应优先查看应用服务器日志（如 catalina.out、access.log、error.log），并检查应用健康检查端点的返回状态。

3.4 数据库连接池耗尽

数据库连接池耗尽是一种典型的“慢刀子割肉”型故障。初期可能仅表现为个别查询变慢，随着连接数持续增长，最终导致所有数据库操作阻塞。在现金流预测模型调优场景中，如果模型训练或预测任务频繁调用数据库，且未合理释放连接，极易触发连接池耗尽。

连接池耗尽的核心原因包括：

• 连接未正确释放：代码中未在 finally 块或 try-with-resources 中关闭连接。
• 连接泄漏：长事务未提交、慢查询长时间占用连接。
• 连接池配置过小：最大连接数（maxActive / maximumPoolSize）低于并发需求。
• 数据库端连接限制：数据库实例的最大连接数（max_connections）被耗尽。

以下是一个典型的连接池配置示例（HikariCP）：

# HikariCP 连接池配置
spring.datasource.hikari.maximum-pool-size=20
spring.datasource.hikari.minimum-idle=5
spring.datasource.hikari.idle-timeout=300000
spring.datasource.hikari.connection-timeout=30000
spring.datasource.hikari.max-lifetime=1800000

3.5 认证与权限问题

认证与权限问题通常表现为用户无法登录、登录后无法访问特定功能模块、或API调用返回401/403状态码。这类故障在ERP系统中尤为常见，因为ERP系统通常采用多租户、多角色、细粒度权限模型，配置复杂度高。

常见原因包括：

• 凭证错误：用户名或密码错误、密码过期、账户被锁定。
• 令牌失效：JWT令牌过期、刷新令牌无效、SSO会话超时。
• 角色/权限缺失：用户未分配“现金流预测模型查看”或“模型参数修改”权限。
• IP白名单限制：用户从非授权IP地址访问ERP系统。

排查认证与权限问题时，应优先检查认证日志（如 audit.log）和权限管理后台，确认用户所属角色与权限分配是否匹配。

-- 查询用户角色与权限
SELECT u.username, r.role_name, p.permission_code
FROM sys_user u
JOIN sys_user_role ur ON u.user_id = ur.user_id
JOIN sys_role r ON ur.role_id = r.role_id
JOIN sys_role_permission rp ON r.role_id = rp.role_id
JOIN sys_permission p ON rp.permission_id = p.permission_id
WHERE u.username = 'zhang_san';

3.6 四类故障的排查流程图

以下SVG流程图展示了从故障发生到根因定位的完整排查路径，帮助运维人员与财务数据分析师建立系统化的排查思维：

3.7 故障分类与排查优先级矩阵

在实际运维中，四类故障并非孤立存在，它们可能相互叠加。例如，数据库连接池耗尽可能由应用层慢查询引发，而应用层慢查询又可能源于网络层延迟。以下矩阵帮助团队快速确定排查优先级：