如何在WildFly管理控制台中显示app.war应用程序描述？

我之前也踩过这个坑！WildFly的Web控制台并不会读取web.xml里的<description>标签来展示应用描述，这是很多新手容易搞错的点。下面给你两种靠谱的解决办法，亲测有效：

方法一：通过MANIFEST.MF配置（推荐） #

WildFly控制台的应用详情页，默认优先读取WAR包中META-INF/MANIFEST.MF文件里的特定属性来展示描述，最常用的是Implementation-Description。

如果你用Maven构建项目 #

直接在pom.xml里配置maven-war-plugin，让它自动帮你生成包含描述的MANIFEST.MF：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-war-plugin</artifactId>
      <version>3.3.2</version>
      <configuration>
        <archive>
          <manifest>
            <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
          </manifest>
          <manifestEntries>
            <!-- 这里替换成你想要展示的应用描述 -->
            <Implementation-Description>我的电商平台应用 - 支持用户注册、订单管理与支付集成</Implementation-Description>
          </manifestEntries>
        </archive>
      </configuration>
    </plugin>
  </plugins>
</build>

手动打包WAR的情况 #

直接在WAR包的META-INF/MANIFEST.MF文件中添加一行：

Implementation-Description: 我的自定义应用描述内容

配置完成后重新打包部署，打开WildFly控制台进入Deployments，点击你的app.war，在Details标签页就能看到你设置的描述了。

方法二：使用jboss-web.xml补充配置 #

如果你想通过JBoss专属配置文件来设置，也可以在WAR的WEB-INF/jboss-web.xml中添加<description>标签，不过这个描述的展示位置可能因WildFly版本略有不同（比如有些版本会在应用的Runtime Name旁显示）：

<jboss-web xmlns="http://www.jboss.com/xml/ns/javaee"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://www.jboss.com/xml/ns/javaee http://www.jboss.org/j2ee/schema/jboss-web_5_1.xsd">
  <context-root>/my-app</context-root>
  <!-- 自定义应用描述 -->
  <description>这是通过jboss-web.xml配置的应用描述</description>
</jboss-web>

为什么web.xml的不生效？ #

Servlet规范里的web.xml <description>标签，主要是给IDE、代码分析工具这类使用的，WildFly的控制台并没有把这个字段作为应用展示描述的来源，所以你之前配置了也看不到效果。

内容的提问来源于stack exchange，提问作者Dmitry Uskov