Quarkus中@PermitAll接口返回401问题求助

你遇到的问题是标记了@PermitAll的登录接口依然返回401，核心原因是SmallRye JWT的认证过滤器仍在拦截该请求，而@PermitAll注解未正确生效或被全局配置覆盖。以下是具体排查步骤和解决方法：

1. 确认@PermitAll注解包导入正确 #

Quarkus版本不同，注解包路径有差异：

• Quarkus 2.x及以上（基于Jakarta EE）：必须导入jakarta.annotation.security.PermitAll
• Quarkus 1.x（基于Java EE）：导入javax.annotation.security.PermitAll

如果导入错误，注解不会被Quarkus安全机制识别，导致接口依然被要求认证。

2. 检查全局权限配置是否覆盖注解 #

若application.properties中配置了全局强制认证规则（如所有路径需认证），会优先于@PermitAll生效。需添加针对登录路径的放行规则：

# 放行登录接口，优先级高于全局认证规则
quarkus.http.auth.permission.login.paths=/user/login
quarkus.http.auth.permission.login.policy=permit

3. 验证quarkus.http.auth.proactive配置 #

虽然你已设置quarkus.http.auth.proactive=false（关闭主动认证，仅在资源需要时触发JWT检查），但如果存在全局权限配置，该参数可能被覆盖。确保没有其他冲突的安全配置。

4. 排查依赖与配置正确性 #

• 确认pom.xml中已添加quarkus-smallrye-jwt依赖：

  <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-smallrye-jwt</artifactId>
  </dependency>
  

• 登录接口无需验证JWT，因此mp.jwt.verify相关配置不会影响该接口的访问权限，无需调整。

5. 临时测试方案 #

可以尝试在AuthRest类上添加@PermitAll注解，覆盖类下所有接口的权限设置，测试是否能正常访问登录接口，以此排查是否是方法级别注解的问题。

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