WildFly 25.0.1运行ee-security示例报ELY01177授权错误如何解决？

1 验证基础配置完整性 #

ee-security示例依赖WildFly Elytron安全域的预配置，首先确认你已完成示例要求的前置配置：

• 进入WildFly的bin目录启动jboss-cli，执行过示例配套的配置命令
• 已创建名为quickstart-domain的安全域，且成功添加用户quickstartUser，密码为quickstartPwd1!、所属角色为quickstartUser
• 部署ee-security.war过程中无报错日志

2 验证请求头传递正确性 #

你当前使用的curl命令在Windows环境下会存在单引号解析问题，不同环境请使用对应命令：

# Linux/macOS 执行
curl -v http://localhost:8080/ee-security/secured -H "X-Username:quickstartUser" -H "X-Password:quickstartPwd1!"
# Windows Powershell 执行
curl.exe -v http://localhost:8080/ee-security/secured -H "X-Username:quickstartUser" -H "X-Password:quickstartPwd1!"

执行后查看WildFly访问日志，确认两个自定义请求头已被正确传递到服务端。

3 开启调试日志定位根因 #

修改WildFly日志配置，开启安全模块的调试级别日志输出：

1. 打开standalone/configuration/standalone.xml，找到logging子系统
2. 添加如下日志配置：

<logger category="org.wildfly.security">
    <level name="DEBUG"/>
</logger>
<logger category="org.wildfly.elytron">
    <level name="DEBUG"/>
</logger>

3. 重启WildFly后重新发起请求，根据日志中的详细报错，确认问题属于身份校验失败还是角色授权失败。

4 针对性修复方案 #

• 若日志提示用户不存在/密码错误：重新执行添加用户命令，确认密码符合WildFly复杂度要求（长度≥8位，包含数字、特殊字符）
• 若日志提示角色授权失败：确认quickstartUser已分配quickstartUser角色，且web.xml中受保护路径的角色配置和分配的角色一致
• 若日志提示JASPI认证模块未注册：确认war包内WEB-INF/classes/META-INF/services/jakarta.security.auth.message.module.ServerAuthModule文件存在，且内容正确指向示例的自定义认证模块

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