在OpenShift 3部署WildFly 10 EAR应用后无法访问项目页面的问题

看起来你的WildFly实例已经正常启动，但你的EAR应用没被正确设置为默认访问项，同时控制台登录也存在配置缺失。我结合之前踩过的WildFly+OpenShift的坑，给你梳理下该补的配置和解决步骤：

一、解决跳转到WildFly欢迎页的问题（让你的EAR成为默认访问项） #

1. 先确认EAR是否被正确构建并部署 #

首先得排查你的应用有没有真的部署成功：

• 用oc get pods找到WildFly的Pod名称，执行oc logs <pod-name>查看构建和部署日志，搜索deploy关键词，看看有没有出现类似Successfully deployed "your-app.ear"的日志。如果有报错（比如依赖缺失、EAR结构问题），先优先解决这些错误。
• 进入容器内部检查部署目录：执行oc rsh <pod-name>，切换到/opt/jboss/wildfly/standalone/deployments/目录，确认你的EAR文件存在，且有对应的.deployed后缀文件（如果是.failed则说明部署失败）。

2. 配置默认Web模块，替换WildFly自带欢迎页 #

WildFly默认会优先加载自带的ROOT.war（欢迎页），你需要把EAR里的Web模块设置为默认：

• 找到WildFly配置文件standalone.xml中<subsystem xmlns="urn:jboss:domain:web:2.2"的部分，添加或修改<default-web-module name="your-war-module-name.war" />（这里的名称要和你EAR内的WAR模块名完全一致）。
• 在OpenShift中，你可以通过ConfigMap挂载自定义的standalone.xml，或者在Git仓库中添加构建脚本，让构建过程自动修改配置。

3. 设置Web模块的上下文根为根路径 #

如果你的WAR模块没指定上下文根，默认访问路径会是http://your-app-url/your-war-name/，而非根路径。要让它直接通过根路径访问：

• 在WAR模块的WEB-INF目录下创建jboss-web.xml，添加以下内容：

<?xml version="1.0" encoding="UTF-8"?>
<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>/</context-root>
</jboss-web>

• 确保这个文件被打包到WAR模块中，然后重新构建推送代码。

二、解决Administration Console无法登录的问题 #

1. 创建WildFly管理用户 #

OpenShift上的WildFly默认没有预创建管理用户，你需要手动添加：

• 进入WildFly容器：oc rsh <pod-name>
• 运行管理用户添加脚本：/opt/jboss/wildfly/bin/add-user.sh
• 按照提示选择Management User，设置用户名和密码，完成后删除当前Pod（oc delete pod <pod-name>），OpenShift会自动重建Pod并加载新用户配置。

2. 通过端口转发访问控制台（安全推荐方式） #

WildFly的管理端口（9990）默认不会通过OpenShift路由暴露（出于安全考虑），你可以用本地端口转发来访问：

• 在本地终端执行：oc port-forward <pod-name> 9990:9990
• 然后在浏览器访问http://localhost:9990/console，用刚才创建的用户登录即可。

3. 公网暴露控制台（不推荐，谨慎操作） #

如果一定要公网访问控制台，需要修改standalone.xml中的管理接口配置：

• 找到<management-interfaces>下的<http-interface>，调整allowed-origins设置为允许你的路由域名，或者暂时去掉限制。但这种做法会带来安全风险，建议只在测试环境使用。

三、额外排查步骤 #

如果上述配置都完成后仍有问题，可以试试：

• 检查EAR的application.xml部署描述符，确认Web模块的名称和路径配置正确。
• 再次查看WildFly服务器日志（oc logs <pod-name>），搜索ERROR或WARN关键词，排查是否有隐藏的部署失败提示。
• 确认Git仓库中的构建配置（比如Maven的pom.xml）是否正确打包EAR，有没有遗漏依赖或插件配置。

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