swagger如何访问（swagger doc.html）

科技前沿 • 2025-05-28 14:13 • 阅读 43

大家好，我是讯享网，很高兴认识大家。

 [TOC]

讯享网

若依简单集成积木报表

本示例以RuoYi-Vue-fast分离版本为例

1、项目结构

讯享网

2、执行初始化脚本`积木报表sql`

jimureport.sql

3、pom中引入积木报表最新依赖

讯享网&lt;dependency&gt; &lt;groupId&gt;org.jeecgframework.jimureport&lt;/groupId&gt; &lt;artifactId&gt;jimureport-spring-boot-starter&lt;/artifactId&gt; &lt;version&gt;${version}&lt;/version&gt; &lt;/dependency&gt;

最新版本可以从 http://jimureport.com/doc/log 中查询到

4、RuoYiApplication添加积木扫描目录

@SpringBootApplication(exclude = { DataSourceAutoConfiguration.class },scanBasePackages = {&quot;org.jeecg.modules.jmreport&quot;,&quot;com.ruoyi&quot;})

5、SecurityConfig拦截排除

目录在ruoyi-framework

讯享网.antMatchers(&quot;/jmreport/&quot;).anonymous()

6、yml中配置minidao（可忽略）

minidao : base-package: org.jeecg.modules.jmreport.desreport.dao*

7、启动项目访问

若依默认端口是8848，可以根据自己的需求集成到若依系统里面(如集成到菜单) 积木报表访问地址：http://localhost:8848/jmreport/list

8、常见问题

a、如果报错Aop

尝试删除pom文件中的devtools依赖

b、需要做权限token传递

详见集成文档-》积木报表token权限

c、需要上传图片

详见集成文档-》文件上传配置

d. 若依集成积木报表`swagger(doc.html)`访问不到

>解决方案，自定义静态资源拦截器即可解决，将doc.html指向指定的swaggerUi路径

讯享网@Configuration
public class SwaggerDocConfig implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
      registry.addResourceHandler(&quot;/static/&quot;).addResourceLocations(&quot;classpath:/static/&quot;);
      registry.addResourceHandler(&quot;doc.html&quot;).addResourceLocations(&quot;classpath:/META-INF/resources/&quot;);
    }
}