Solr配置Azure OAuth2时JWTAuthPlugin类加载失败求助

1. 核对Solr版本兼容性 #

JWTAuthPlugin是Solr 8.4及以后版本才内置的官方插件，如果你使用的Solr镜像版本低于8.4，必然会出现类加载失败。先检查docker-compose.yml里的Solr镜像标签，比如把solr:8.3替换为solr:8.4或更高版本。

2. 修正security.json配置 #

确保配置文件中认证插件的类名拼写完全正确（大小写敏感），同时验证Azure AD相关参数：

{
  "authentication": {
    "class": "solr.JWTAuthPlugin",
    "jwksUrl": "https://login.microsoftonline.com/你的租户ID/discovery/v2.0/keys",
    "usernameClaim": "upn",
    "rolesClaim": "roles"
  },
  "authorization": {
    "class": "solr.RuleBasedAuthorizationPlugin",
    "permissions": [
      {
        "name": "security-edit",
        "role": "admin"
      }
    ]
  }
}

注意替换你的租户ID为实际Azure AD租户ID，避免因URL错误导致插件初始化失败。

3. 检查容器网络连通性 #

Azure App Service的Docker容器可能存在出站网络限制，进入容器执行以下命令验证能否访问Azure AD的JWKS端点：

curl https://login.microsoftonline.com/你的租户ID/discovery/v2.0/keys

如果无法访问，需要在App Service的网络设置中允许出站请求到login.microsoftonline.com域名。

4. 确认插件依赖完整性 #

官方Solr镜像默认包含JWTAuthPlugin的依赖包，若使用自定义镜像，检查容器内/opt/solr/server/solr-webapp/webapp/WEB-INF/lib目录下是否存在solr-jwt-plugin-*.jar文件。如果缺失，改用官方标准镜像重新部署。

5. 排除核心初始化其他问题 #

先恢复之前正常的Basic Auth配置，启动Solr验证CoreContainer能否正常初始化，排除核心配置错误、存储挂载异常等其他问题。确认基础功能正常后，再重新配置JWTAuthPlugin。

6. 验证令牌有效性（类加载正常后） #

当插件加载成功后，使用jwt.io解析Bearer令牌，确认令牌包含配置中指定的usernameClaim和rolesClaim，且签名由Azure AD有效签名。

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