Ubuntu环境下WebLogic如何进行故障排查

Ubuntu环境下WebLogic故障排查指南

1. 日志分析（首要步骤）

日志是故障排查的核心依据，WebLogic的日志文件集中存储在**$DOMAIN_HOME/logs**目录下（$DOMAIN_HOME为域根目录，可通过echo $DOMAIN_HOME确认），关键日志包括：

• server.log：记录服务器启动、运行及错误信息（如端口冲突、配置错误）；
• access.log：记录HTTP请求访问日志（用于排查请求响应问题）；
• console.log：控制台输出日志（包含启动过程中的实时信息）。

查看日志的常用命令：

• 动态跟踪最新日志：tail -f $DOMAIN_HOME/logs/server.log；
• 查找特定关键字（如“ERROR”）：grep -i 'error' $DOMAIN_HOME/logs/server.log；
• 使用文本编辑器查看详情：vi $DOMAIN_HOME/logs/server.log（需掌握vi基本操作）。
  通过日志中的错误代码（如BEA-XXXXX）或堆栈跟踪，可快速定位问题根源（如类加载失败、数据库连接异常）。

2. 配置文件检查

WebLogic的配置文件错误是常见故障原因，需重点检查以下文件：

• $DOMAIN_HOME/config/config.xml：域的核心配置文件（包含服务器实例、集群、数据源、监听端口等配置）；
• $DOMAIN_HOME/config/weblogic.xml：应用的WebLogic特定配置（如类加载顺序、安全角色映射）；
• $DOMAIN_HOME/bin/startWebLogic.sh：启动脚本（包含JVM内存参数、环境变量设置）。

检查要点：

• 确认配置文件语法正确（无遗漏标签、属性值格式正确）；
• 验证监听端口（如7001、7002）是否符合业务需求且未被其他进程占用（使用netstat -tulnp | grep <端口号>命令）；
• 确保环境变量（如JAVA_HOME）设置正确（指向有效的JDK安装路径，可通过echo $JAVA_HOME验证）。

3. 端口冲突排查

WebLogic默认使用7001（HTTP）、7002（HTTPS）等端口，若这些端口被其他应用（如Apache、Nginx、其他WebLogic实例）占用，会导致启动失败。
排查步骤：

• 执行netstat -tulnp | grep <端口号>（如netstat -tulnp | grep 7001），查看端口占用进程；
• 若端口被占用，可选择：
  • 修改WebLogic端口：编辑$DOMAIN_HOME/config/config.xml中的<listen-port>标签，重启服务器；
  • 终止占用进程：kill -9 <进程ID>（需谨慎操作，避免影响其他服务）。

4. 内存配置优化

内存不足或配置不当（如堆内存过小）会导致OutOfMemoryError（OOM），表现为服务器启动缓慢、应用响应延迟或崩溃。
排查与解决步骤：

• 查看当前内存配置：编辑$DOMAIN_HOME/bin/startWebLogic.sh，找到JAVA_OPTIONS参数（如-Xms512m -Xmx1024m，分别表示初始堆大小和最大堆大小）；
• 调整内存参数：根据服务器资源（如16GB内存的Ubuntu服务器，可设置为-Xms2g -Xmx4g）；
• 分析内存泄漏：若频繁出现OOM，使用jmap生成堆转储文件（jmap -dump:format=b,file=/tmp/heap.hprof <pid>），再用**Memory Analyzer（MAT）**工具分析内存占用情况，定位泄漏点（如未关闭的数据库连接、缓存未清理）。

5. 进程与服务状态检查

确认WebLogic服务是否正常运行，以及进程是否存在异常。
常用命令：

• 查看WebLogic进程：ps -ef | grep weblogic（若进程不存在，说明服务未启动）；
• 启动/停止服务：./startWebLogic.sh（前台启动，查看实时日志）、nohup ./startWebLogic.sh &（后台启动，日志输出到nohup.out）；
• 停止服务：./stopWebLogic.sh（需进入域的bin目录）。
  若进程存在但服务无法访问，可能是线程挂起或资源耗尽，需进一步排查。

6. 线程与内存诊断（针对挂起/崩溃问题）

若WebLogic服务器挂起（无响应）或频繁崩溃，需通过以下命令诊断：

• 线程转储：获取线程堆栈信息，分析死锁或长时间运行的任务。执行jstack <pid> > /tmp/thread_dump.txt（<pid>为WebLogic进程ID，可通过ps -ef | grep weblogic获取），用文本编辑器打开thread_dump.txt，查找“deadlock”（死锁）或“BLOCKED”（阻塞）状态的线程；
• 内存分析：使用jmap查看堆内存使用情况（jmap -heap <pid>），确认堆内存是否耗尽；
• JMX监控：通过JMX客户端（如JConsole、VisualVM）连接到WebLogic服务器，实时监控内存、线程、CPU等指标（需提前开启JMX服务，编辑startWebLogic.sh添加-Dcom.sun.management.jmxremote参数）。

7. 依赖服务验证

WebLogic依赖的外部服务（如数据库、缓存、消息队列）异常，会导致应用部署或运行失败。
检查要点：

• 确认依赖服务已启动（如MySQL：systemctl status mysql）；
• 验证连接配置（如数据库URL、用户名、密码是否正确，可通过telnet <数据库IP> <端口>测试网络连通性）；
• 检查应用配置文件（如web.xml、persistence.xml）中的依赖服务配置是否正确。

8. 常见错误及快速解决

• 错误1：BEA-000386（无法获取localhost地址）：
  原因：网络配置错误（如/etc/hosts文件中未绑定localhost）。
  解决：编辑/etc/hosts，添加127.0.0.1 localhost，重启服务器。
• 错误2：ClassNotFoundException/NoClassDefFoundError：
  原因：应用依赖库缺失或类路径配置错误。
  解决：检查WAR/EAR文件中的WEB-INF/lib目录，确保所有依赖库存在；或修改WebLogic的CLASSPATH配置（在startWebLogic.sh中添加依赖库路径）。
• 错误3：OutOfMemoryError：
  原因：堆内存不足或内存泄漏。
  解决：调整JAVA_OPTIONS中的堆内存大小（如-Xms2g -Xmx4g）；使用MAT分析堆转储文件，修复内存泄漏。