如何配置WebSphere 16.0.0.4(WLP)获取Spring应用启动异常日志？

这种只抛出模糊的exception.occurred.while.running.ServletContainerInitializers.onStartup日志、看不到具体异常栈的情况，我在WebSphere部署Spring应用时也遇到过——大概率是类加载失败、依赖缺失或者Spring初始化过程中的隐性错误，下面是我亲测有效的解决方案：

一、先快速定位异常根源（不用先开全量trace） #

1. 优先检查SystemOut.log和SystemErr.log
   WebSphere很多时候会把Servlet容器初始化阶段的异常直接输出到系统日志里，而非trace.log。去服务器日志目录（默认路径为profile_root/logs/server_name/）找到这两个文件，搜索Exception或Error关键词，大概率能找到完整错误栈，比如ClassNotFoundException或NoClassDefFoundError，这类信息往往直接指向依赖缺失或损坏的问题。

2. 启用Servlet容器初始化调试参数
   在WebSphere服务器的JVM启动参数中添加：

   -Djavax.servlet.ServletContainerInitializer.onStartup.debug=true
   

   这是Servlet规范自带的调试开关，会强制容器在初始化ServletContainerInitializer（比如Spring的SpringServletContainerInitializer）时打印完整异常栈，包括触发错误的具体类和方法，能快速揪出类加载或依赖相关问题。

二、精准配置Trace日志，避免生成冗余内容 #

如果上面的方法还没解决问题，再针对性配置trace，绝对不要直接全开*=all（会生成巨量无用日志），只跟踪与问题相关的核心组件：

方法1：通过WebSphere控制台配置 #

1. 登录WebSphere管理控制台，导航到 服务器 -> 日志和跟踪 -> 你的目标服务器 -> 跟踪
2. 在「跟踪字符串」中输入精准的跟踪规则，比如针对Spring初始化、WebSphere Web容器、类加载这三个核心模块：

   org.springframework.web.SpringServletContainerInitializer=all:com.ibm.ws.webcontainer.servlet=all:com.ibm.ws.classloading=all
   

   • org.springframework.web.SpringServletContainerInitializer=all：跟踪Spring初始化类的所有日志
   • com.ibm.ws.webcontainer.servlet=all：跟踪WebSphere Servlet容器的初始化过程
   • com.ibm.ws.classloading=all：跟踪类加载相关日志，排查依赖缺失/冲突
3. 点击「应用」后重启服务器，此时查看trace.log就能得到精准的调试信息，不会被无关模块的日志干扰。

方法2：通过server.xml配置（适合自动化部署） #

如果用配置文件管理服务器，直接在server.xml中添加traceSpecification元素：

<traceSpecification specification="org.springframework.web.SpringServletContainerInitializer=all:com.ibm.ws.webcontainer.servlet=all:com.ibm.ws.classloading=all" />

额外优化：设置trace日志滚动策略 #

为避免trace.log文件过大，记得配置日志滚动规则：
在控制台的「日志和跟踪 -> 你的服务器 -> 文件滚动策略」中，设置按大小（如100MB）或时间（如每天）滚动，同时保留最近5-10个日志文件，方便后续排查。

三、额外排查技巧：类加载器分析 #

如果怀疑是依赖冲突或缺失，WebSphere自带的类加载器查看器能帮上忙：
导航到 问题诊断 -> 类加载器查看器，选择你的应用，就能查看应用的类加载路径、已加载的类，以及是否存在类版本冲突，快速定位缺失的依赖JAR。

内容的提问来源于stack exchange，提问作者Georg Sirnes Lundesgaard