From 8bb6cc8b2af6a30f1b4f0f123541f6c7d28b3c21 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=BC=80=E6=BA=90=E6=B5=B7=E5=93=A5?= Date: Tue, 13 Jun 2023 10:07:44 +0800 Subject: [PATCH] docs: update faq.md --- docs/zh/faq.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/zh/faq.md b/docs/zh/faq.md index 64d75dfb..3f0b1978 100644 --- a/docs/zh/faq.md +++ b/docs/zh/faq.md @@ -6,6 +6,15 @@ MyBatis-Flex 使用了 APT 技术，这两个类是自动生成的。 参考：[MyBatis-Flex APT 配置 - MyBatis-Flex 官方网站](./others/apt.md) +## 启动出错？目前社区反馈有如下几个错误原因 + + +- 1、添加了错误的数据源依赖版本，比如 SpringBoot v2.x 使用 HikariCP 时，应该是 HikariCP 的 4.x 版本。而 SpringBoot v3.x 应该使用 HikariCP 的 5.x 版本。 +- 2、主动添加了 MyBatis 或者 `mybatis-spring-boot-starter` 的依赖，导致版本不匹配。使用 SpringBoot 的情况下，应该引用 `mybatis-flex-spring-boot-starter` 就可以了，不需要再添加其他 MyBatis 依赖。 +- 3、使用了 `druid-spring-boot-starter` 依赖，导致 flex 的 DataSource 无法被接管。应该使用 `druid` 就可以了，不要用 `druid-spring-boot-starter`。 +- 4、使用了 `MyBatis-Plus` 或者 `pagehelper-spring-boot-starter` 而被这些框架优先初始化 MyBatis， MyBatis-Flex 未得到初始化。 + + ## SpringBoot 项目，启动报错 Property 'sqlSessionFactory' or 'sqlSessionTemplate' are required