{"record":{"id":"529c95e3a16d7454","repo":"dromara/Sa-Token","slug":"springboot-version-sa-token-529c95","errorCode":null,"errorMessage":"当前 SpringBoot 版本（\" + version + \"）与 Sa-Token 依赖不兼容，请将依赖 sa-token-spring-boot-starter 修改为：sa-token-spring-boot3/4-starter","messagePattern":"当前 SpringBoot 版本（\" \\+ version \\+ \"）与 Sa-Token 依赖不兼容，请将依赖 sa-token-spring-boot-starter 修改为：sa-token-spring-boot3/4-starter","errorType":"exception","errorClass":"SaTokenException","httpStatus":null,"severity":"error","filePath":"sa-token-starter/sa-token-spring-boot-starter/src/main/java/cn/dev33/satoken/spring/SpringBootVersionCompatibilityChecker.java","lineNumber":23,"sourceCode":"import org.springframework.boot.SpringBootVersion;\r\n\r\n/**\r\n * SpringBoot 版本与 Sa-Token 版本兼容检查器，当开发者错误的在 SpringBoot3/4.x 项目中引入当前集成包时，将在控制台做出提醒并阻断项目启动\r\n *\r\n * @author Uncarbon\r\n * @since 1.38.0\r\n */\r\npublic class SpringBootVersionCompatibilityChecker {\r\n\r\n    public SpringBootVersionCompatibilityChecker() {\r\n        String version = SpringBootVersion.getVersion();\r\n        if (SaFoxUtil.isEmpty(version) || version.startsWith(\"1.\") || version.startsWith(\"2.\")) {\r\n            return;\r\n        }\r\n        String str = \"当前 SpringBoot 版本（\" + version + \"）与 Sa-Token 依赖不兼容，\" +\r\n                \"请将依赖 sa-token-spring-boot-starter 修改为：sa-token-spring-boot3/4-starter\";\r\n        System.err.println(str);\r\n        throw new SaTokenException(str);\r\n    }\r\n}\r\n","sourceCodeStart":5,"sourceCodeEnd":26,"githubUrl":"https://github.com/dromara/Sa-Token/blob/ac2c7f6e94a78573cf0bcb932dd8b04e68fad189/sa-token-starter/sa-token-spring-boot-starter/src/main/java/cn/dev33/satoken/spring/SpringBootVersionCompatibilityChecker.java#L5-L26","documentation":"Error \"当前 SpringBoot 版本（\" + version + \"）与 Sa-Token 依赖不兼容，请将依赖 sa-token-spring-boot-starter 修改为：sa-token-spring-boot3/4-starter\" thrown in dromara/Sa-Token.","triggerScenarios":"Thrown at sa-token-starter/sa-token-spring-boot-starter/src/main/java/cn/dev33/satoken/spring/SpringBootVersionCompatibilityChecker.java:23 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["当前项目运行在 SpringBoot 3.x/4.x，却引入了面向 SpringBoot 2.x 的 sa-token-spring-boot-starter。将依赖改为 sa-token-spring-boot3-starter（SpringBoot 3.x）或 sa-token-spring-boot4-starter（SpringBoot 4.x）。","注意 SpringBoot 3.x 使用 jakarta.servlet 命名空间，更换 starter 后同步检查代码中 javax.servlet 相关 import。"],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"ac2c7f6e94a78573cf0bcb932dd8b04e68fad189","analyzedAt":"2026-08-14T14:36:10.271Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}