Spring Boot Security输入凭据后返回500内部错误排查求助

核心报错java.lang.UnsatisfiedLinkError表明JVM无法找到Waffle依赖的JNI本地库，这是Waffle集成时的常见问题——Waffle通过JNI调用Windows系统SSPI接口，必须加载对应的本地库文件（如waffle-jna.dll）才能正常工作。以下是具体排查和解决步骤：

1. 确认依赖完整性 #

确保构建文件（Maven/Gradle）正确引入Waffle Spring Security依赖，它会自动传递依赖包含本地库的waffle-jna：

Maven示例： #

<dependency>
    <groupId>com.github.waffle</groupId>
    <artifactId>waffle-spring-security</artifactId>
    <version>4.1.8.2</version>
</dependency>

Gradle示例： #

implementation 'com.github.waffle:waffle-spring-security:4.1.8.2'

执行构建命令（mvn clean install/gradle build）后，检查target/native-libs（Maven）或build/native-libs（Gradle）目录下是否存在对应平台的本地库文件（Windows下为waffle-jna.dll）。

2. 指定JVM本地库搜索路径 #

Smart Tomcat插件的类加载机制可能导致JVM无法自动识别Waffle的本地库，需要手动指定java.library.path：

• 打开IntelliJ的Run/Debug Configurations
• 选中你的Smart Tomcat配置
• 在VM options中添加：

  -Djava.library.path=${project.build.directory}/native-libs
  

  （Gradle项目替换为${project.buildDir}/native-libs）

3. 检查平台与JVM位数匹配 #

• Windows环境下，确保JDK位数与本地库位数一致：64位JDK对应64位waffle-jna.dll，32位JDK对应32位库
• 验证JDK位数：执行java -version，输出会标注64-Bit或32-Bit

4. 验证Security配置正确性 #

检查你的Security配置类，避免在初始化阶段提前触发JNI加载：

• 确保NegotiateSecurityFilter或BasicSecurityFilter通过Spring Bean正确初始化，不要在配置阶段直接调用依赖JNI的方法
• 示例配置片段：

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Autowired
    private NegotiateSecurityFilter negotiateSecurityFilter;

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.addFilterBefore(negotiateSecurityFilter, BasicAuthenticationFilter.class)
            .authorizeRequests()
            .anyRequest().authenticated();
    }

    @Bean
    public NegotiateSecurityFilter negotiateSecurityFilter() {
        NegotiateSecurityFilter filter = new NegotiateSecurityFilter();
        filter.setProvider(new WindowsAuthProvider());
        return filter;
    }
}

5. 版本兼容性排查 #

当前依赖组合（Spring Boot 2.3.1 + Spring Security 5.3.3 + Waffle 4.1.8.2）理论上兼容，若上述步骤无效，可尝试调整Waffle版本：

• 降级到Waffle 4.0.0或升级到4.2.0，验证是否解决兼容性问题

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