IBM WebSphere Liberty 17.0.0.1：上下文根未找到问题求助

结合你给出的配置片段和Liberty版本特性，我整理了几个最常见的排查方向，帮你解决这个问题：

• 检查application配置的context-root属性
  从你贴的server.xml片段来看，<application>元素的配置不完整，很可能没指定context-root。Liberty默认会用war包文件名（去掉.war后缀）作为上下文根，但如果是EAR包或者需要自定义路径，必须显式配置：

  • 对于WAR包，直接在<application>里添加属性：

    <application id="myApp" location="myApp.war" context-root="/myApp"/>
    

  • 对于EAR包，要么在EAR的META-INF/application.xml中给Web模块指定context-root，要么在server.xml里嵌套<webApplication>子元素：

    <application id="myEarApp" location="myApp.ear">
        <webApplication id="myWebModule" context-root="/myWeb"/>
    </application>
    

• 确认应用是否成功完成部署
  很多时候"上下文根未找到"其实是应用部署失败导致的，建议：

  • 查看Liberty的日志文件：logs/messages.log和logs/console.log，搜索关键字Application ... started确认应用正常启动，或者有没有类加载错误、依赖缺失等异常信息。
  • 用server status <你的服务器名>命令检查服务器运行状态，确保没有部署中断的情况。

• 补充Web容器相关的feature
  你当前的feature列表里有jsp-2.2，但建议显式添加servlet-3.1（Liberty 17.0.0.1支持的版本），确保Web容器功能完整，避免因隐式依赖缺失导致的部署问题：

  <featureManager>
      <feature>appSecurity-2.0</feature>
      <feature>concurrent-1.0</feature>
      <feature>ejbLite-3.1</feature>
      <feature>jndi-1.0</feature>
      <feature>jpa-2.0</feature>
      <feature>jsp-2.2</feature>
      <feature>localConnector-1.0</feature>
      <feature>servlet-3.1</feature> <!-- 显式添加Web核心功能 -->
  </featureManager>
  

• 验证访问路径的正确性

  • 如果配置的context-root是/myApp，那么正确的访问路径应该是http://<服务器地址>:<HTTP端口>/myApp，注意Liberty默认HTTP端口是9080，不要搞错端口。
  • 配置context-root时，建议统一使用带开头/的写法，避免路径解析歧义。

• 清理缓存后重新部署
  有时候缓存会导致部署异常，试试以下步骤：

  1. 停止服务器：server stop <你的服务器名>
  2. 清理缓存：server clean <你的服务器名>
  3. 删除wlp/usr/servers/<你的服务器名>/apps下的已部署文件（比如展开的war/ear目录）
  4. 重新启动服务器：server start <你的服务器名>

内容的提问来源于stack exchange，提问作者Catalin Gabriel Gherasim