当前位置: 首页 > news >正文

knife4j在配置文件(xml文件)的配置错误

knife4j:enable: trueopenapi:title: 支付接口文档description: "支付接口文档"email: zhanghuyi@itcast.cnconcat: 虎哥url: https://www.itcast.cnversion: v1.0.0group:default:group-name: defaultapi-rule: packageapi-rule-resources:- com.hmall.controller

❗问题根源:配置类中 api-rule-resources:的包写错了

导致访问http://localhost:8085/doc.html不会出现接口文档

✅ 你现在的状态:

项目状态
knife4j.enable: true✅ 启用了 Knife4j
knife4j.openapi 配置✅ 写了 OpenAPI3 风格的配置
配置类没有写 OpenAPI 配置类
扫描包❌ 配置的是 com.hmall.controller,但你的 PayControllercom.hmall.pay.controller

✅ 解决步骤(一步到位)

✅ 1. 替换依赖:使用 Knife4j 的 OpenAPI3 版本

把你的 pom.xml 里加上:

<!-- Knife4j 基于 OpenAPI3 -->
<dependency><groupId>com.github.xiaoymin</groupId><artifactId>knife4j-openapi3-spring-boot-starter</artifactId><version>4.1.0</version>
</dependency>

⚠️ 注意:这个版本对应的是 OpenAPI3,不是你现在的 knife4j-spring-boot-starter(那是 Swagger2)。


✅ 2. 修改 application.yml 配置

你当前的配置是 OpenAPI3 风格,但 包路径写错了

把这段:

knife4j:enable: trueopenapi:title: 支付接口文档description: "支付接口文档"email: zhanghuyi@itcast.cnconcat: 虎哥url: https://www.itcast.cn version: v1.0.0group:default:group-name: defaultapi-rule: packageapi-rule-resources:- com.hmall.controller  # ❌ 错误路径

改成:

knife4j:enable: trueopenapi:title: 支付接口文档description: "支付接口文档"email: zhanghuyi@itcast.cnconcat: 虎哥url: https://www.itcast.cn version: v1.0.0group:default:group-name: defaultapi-rule: packageapi-rule-resources:- com.hmall.pay.controller  # ✅ 正确路径

✅ 3. 不需要写配置类(Knife4j 自动配置)

只要你用了 knife4j-openapi3-spring-boot-starter不需要写任何 @Configuration,它会自动扫描并注册 OpenAPI Bean。


✅ 4. 重启项目,访问:

  • 文档页面:http://localhost:8085/doc.html
  • OpenAPI JSON:http://localhost:8085/v3/api-docs

✅ 总结:你只需要做两件事

| 操作 | 内容 |
| ✅ 改路径 | 把 com.hmall.controller 改成 com.hmall.pay.controller |



http://www.dtcms.com/a/548773.html

相关文章:

  • Java的多线程——多线程(二)
  • 小企业也能用AI?低成本智能转型实战案例
  • ros2 播放 ros1 bag
  • 网页设计做一个网站设计之家官方网站
  • 基于STM32单片机 + DeepSeek-OCR 的智能文档扫描助手设计与实现
  • 微信小程序如何传递参数
  • 【数据结构】:数组及特殊矩阵
  • 记录一下微信小程序里使用SSE
  • API 接口安全:用 JWT + Refresh Token 解决 Token 过期与身份伪造问题
  • 云手机搬砖 高效采集资源
  • GitHub Actions CI/CD 自动化部署完全指南
  • Fastlane 结合 开心上架 命令行版本实现跨平台上传发布 iOS App
  • 广东营销网站建设服务公司军事信息化建设网站
  • Go Web 编程快速入门 14 - 性能优化与最佳实践:Go应用性能分析、内存管理、并发编程最佳实践
  • LeetCode每日一题——合并两个有序链表
  • 丽江市建设局官方网站门户网站开发需要多少钱
  • 边缘计算中评估多模态分类任务的延迟
  • 11.9.16.Filter(过滤器)
  • 光储充微电网能量管理系统:构建绿色、高效、安全的能源未来
  • MR30分布式IO在自动上料机的应用
  • 有些网站为什么可以做资讯建站工具交流
  • .NET周刊【10月第2期 2025-10-12】
  • 自动化文献引用和交叉引用高亮显示:Word VBA宏解决方案
  • 大数据离线处理:使用 Airflow 调度 Hive 脚本的工作流设计
  • 深入理解二叉搜索树:从原理到实现
  • Rust 泛型参数的实践与思考
  • AppML 案例:Employees 应用解析
  • 【Qt开发】布局管理器(一)-> QVBoxLayout垂直布局
  • CF练习记录~
  • 自动化测试 | 认识接口自动化封装中的YAML用例