解决springsecurity+knife4j，无法访问knife4j资源

### 解决Spring Security与Knife4j集成时无法访问资源的问题 当遇到Spring Security与Knife4j集成导致的无法访问资源问题时，通常是因为安全配置阻止了对Swagger UI页面及其相关静态文件的访问。以下是详细的解决方案： #### 配置冲突排查 为了确保能够正常访问`/doc.html`以及其他API文档路径，在应用的安全配置类中需要特别处理这些URL模式。对于Spring Boot 2.x及以上版本的应用程序来说，可以通过自定义WebSecurityConfigurerAdapter来实现这一点。 ```java @EnableWebSecurity public class WebSecurityConfig extends WebSecurityConfigurerAdapter { @Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers("/swagger-ui/**", "/v3/api-docs/**").permitAll() // 放开knife4j接口地址 .anyRequest().authenticated(); // 关闭csrf防护机制以便于测试环境下的api调用更加方便 http.csrf().disable(); } } ``` 上述代码片段展示了如何通过覆盖`configure(HttpSecurity)`方法并使用`antMatchers()`函数指定允许匿名访问的具体路径列表[^2]。 #### 权限设置调整 除了放开特定端点外，还需要考虑整个应用程序级别的安全性策略是否合理。如果启用了CSRF保护，则可能会影响表单提交等功能；因此可以根据实际情况决定是否禁用它（仅适用于开发阶段）。另外，考虑到前后端分离架构下跨域资源共享的需求，适当放宽CORS政策也是必要的措施之一。 针对CSP(Content Security Policy)，这是一种HTTP响应头部字段，用于增强网页加载外部资源时的安全性控制。由于Knife4j依赖于JavaScript库动态渲染界面，所以应当确认服务器返回的内容安全策略不会阻碍此类操作。具体做法是在控制器层面上添加相应的header属性: ```java import org.springframework.web.bind.annotation.ControllerAdvice; import org.springframework.web.servlet.mvc.method.annotation.ResponseBodyAdvice; @ControllerAdvice(basePackages = "com.example.controller") public class GlobalResponseAdvice implements ResponseBodyAdvice<Object> { @Override public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) { return true; } @Override public Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType, Class<? extends HttpMessageConverter<?>> selectedConverterType, ServerHttpRequest request, ServerHttpResponse response) { HttpServletResponse rawResponse = ((ServletServerHttpResponse)response).getServletResponse(); rawResponse.setHeader("Content-Security-Policy", "default-src 'self'; script-src 'unsafe-inline' 'unsafe-eval'"); return body; } } ``` 这段代码实现了全局范围内的响应体拦截器，并向每个响应附加了一个较为宽松的CSP声明，从而允许执行内联脚本以及评估表达式[^3]。 最后需要注意的是，随着不同框架版本之间的差异，某些配置项可能会有所变化。例如从Spring Boot 2迁移到3的过程中遇到了兼容性问题，这可能是由新的默认行为引起或者是第三方组件本身的更新所致。在这种情况下，查阅官方文档或社区反馈往往能提供有效的指导[^1]。