快捷導(dǎo)航

SpringBoot啟動(dòng)失敗Application?run?failed的問(wèn)題分析及解決辦法

更新時(shí)間：2026年01月20日 08:51:09 作者：二哈喇子！

文章主要介紹了SpringBoot啟動(dòng)失敗的問(wèn)題分析和解決辦法,包括XML文件格式錯(cuò)誤、數(shù)據(jù)庫(kù)名稱錯(cuò)誤以及MyBatis掃描路徑問(wèn)題的排查和修復(fù)步驟,感興趣的朋友跟隨小編一起看看吧

前言

Navicat 能看本地?cái)?shù)據(jù)庫(kù)和服務(wù)器數(shù)據(jù)庫(kù)，具體是哪里的數(shù)據(jù)庫(kù)要看清楚，最好cmd命令show databases看一下

項(xiàng)目場(chǎng)景一：Application run failed

提示：SpringBoot服務(wù)啟動(dòng)的時(shí)候報(bào)錯(cuò):
這個(gè)問(wèn)題遇到好多次了，一直沒(méi)能記錄下來(lái)，今天又碰到了

Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
ERROR 1572 --- [  restartedMain] o.s.boot.SpringApplication               : Application run failed

?? 錯(cuò)誤總覽

下面是錯(cuò)誤報(bào)告我用回車隔開(kāi)方便查看

Error creating bean with name 'userAction': 
Unsatisfied dependency expressed through field 'userService'; 
nested exception is ... 
Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException: 
Error creating bean with name 'userServiceImpl': 
nested exception is ... 
Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException: 
Error creating bean with name 'userMapper' defined in file [...] 
nested exception is ... 
Caused by: org.springframework.beans.factory.BeanCreationException: 
Error creating bean with name 'sqlSessionFactory' ... 
nested exception is ... 
Caused by: org.springframework.beans.BeanInstantiationException: 
Failed to instantiate [org.apache.ibatis.session.SqlSessionFactory]... 
nested exception is org.springframework.core.NestedIOException: 
Failed to parse mapping resource: 'file [.../mapper/UserMapper.xml]'... 
nested exception is org.apache.ibatis.builder.BuilderException: 
Error creating document instance. Cause: org.xml.sax.SAXParseException; lineNumber: 1; columnNumber: 36;
在 XML 聲明中的編碼偽屬性前面必須有空格。

?? 錯(cuò)誤根本原因

UserMapper.xml 文件的第一行 XML 聲明格式不正確。

具體報(bào)錯(cuò)是：

在 XML 聲明中的編碼偽屬性前面必須有空格。

這個(gè)錯(cuò)誤通常出現(xiàn)在 XML 文件的最開(kāi)始一行，也就是：

<?xml version="1.0" encoding="UTF-8"?><!-- 正確寫法 -->

但你的文件可能寫成了：

<?xml version="1.0"encoding="UTF-8"?> <!-- ? 錯(cuò)誤：沒(méi)有空格 -->

或者：

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>

其中某個(gè)地方少了空格、引號(hào)沒(méi)閉合、語(yǔ)法不對(duì)等。

? 解決方案

? 第一步：檢查UserMapper.xml的第一行

打開(kāi)文件：

E:\桌面\springbootdemo\target\classes\mapper\UserMapper.xml

（注意：這個(gè)路徑是你編譯后的路徑，實(shí)際修改應(yīng)該去源碼目錄下的 XML 文件）

找到類似這一行：

<?xml version="1.0"encoding="UTF-8"?>

改成：

<?xml version="1.0" encoding="UTF-8"?>

確保：

version 和 encoding 屬性之間有空格
encoding="UTF-8" 寫法正確
沒(méi)有多余的字符或拼寫錯(cuò)誤

? 第二步：驗(yàn)證 XML 是否語(yǔ)法正確

你可以將整個(gè) XML 文件粘貼到在線 XML 驗(yàn)證工具中，例如：

https://www.xmlvalidation.com/

它會(huì)告訴你哪一行哪個(gè)位置出錯(cuò)了。

? 第三步：重新構(gòu)建項(xiàng)目

修改完 XML 后，在命令行執(zhí)行：

mvn clean install
# 或者
gradle clean build

然后重啟 Spring Boot 應(yīng)用。

?? 示例修復(fù)前 vs 修復(fù)后

? 錯(cuò)誤示例：

<?xml version="1.0"encoding="UTF-8"?>
<mapper namespace="cn.edu.neu.springbootdemo.mapper.UserMapper">
    ...
</mapper>

? 正確示例：

<?xml version="1.0" encoding="UTF-8"?>
<mapper namespace="cn.edu.neu.springbootdemo.mapper.UserMapper">
    ...
</mapper>

?? 小貼士

問(wèn)題	建議
XML 報(bào)錯(cuò)定位難	使用 IDE 打開(kāi) XML 文件，一般會(huì)有語(yǔ)法高亮提示
編碼格式混亂	確保文件保存為 UTF-8 格式
中文亂碼	在 XML 頭部聲明 encoding=“UTF-8” 并保持文件編碼一致
Mapper 路徑未掃描到	檢查是否配置了 MyBatis 的 mapper-locations

? 總結(jié)

步驟	內(nèi)容
1??	定位到 `UserMapper.xml` 文件
2??	修改 XML 聲明頭，補(bǔ)上空格，如：`<?xml version="1.0" encoding="UTF-8"?>`
3??	清理并重新構(gòu)建項(xiàng)目
4??	重啟應(yīng)用

場(chǎng)景分析二：Application run failed

Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
2022-10-14 13:15:21.461 ERROR 12548 --- [           
    main] o.s.boot.SpringApplication               
    : Application run failed

原因分析

往下看原因：Caused by:

下面是錯(cuò)誤報(bào)告我用回車隔開(kāi)方便檢查

Unsatisfied dependency expressed through bean property 'sqlSessionFactory'; nested exception is org.springframework.beans.factory.BeanCreationException: 
Error creating bean with name 'sqlSessionFactory' defined in class path resource [com/baomidou/mybatisplus/spring/boot/starter/MybatisPlusAutoConfiguration.class]: 
Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: 
Failed to instantiate [org.apache.ibatis.session.SqlSessionFactory]: 
Factory method 'sqlSessionFactory' threw exception; 
nested exception is com.baomidou.mybatisplus.exceptions.MybatisPlusException: 
Error: GlobalConfigUtils setMetaData Fail !  
Cause:java.sql.SQLSyntaxErrorException: Unknown database 'jiakao'

重點(diǎn)在最后一句，他說(shuō)我這個(gè)錯(cuò)誤是：GlobalConfigUtils setMetaData失敗！

原因：java.sql SQLSyntaxErrorException:未知數(shù)據(jù)庫(kù)“jiakao”

解決辦法

上面的錯(cuò)誤說(shuō)數(shù)據(jù)庫(kù)名字不對(duì)

打開(kāi)數(shù)據(jù)庫(kù)可視化工具一看，是數(shù)據(jù)庫(kù)名字打錯(cuò)了

果然數(shù)據(jù)庫(kù)名字一改后，立馬跑通

總結(jié)：

重要的不是問(wèn)題解決了，重要的是解決問(wèn)題的過(guò)程
還有error才會(huì)影響程序的運(yùn)行，warning警告不用管
根據(jù)錯(cuò)誤的提示去想，為什么找不到這個(gè)bean/class？通過(guò)這個(gè)錯(cuò)誤一步步去跟蹤，找到根本的原因，這是積累知識(shí)的過(guò)程
等以后這種問(wèn)題發(fā)現(xiàn)地慢慢的多起來(lái)，慢慢地積累起來(lái)，積累的經(jīng)驗(yàn)越多越好
英語(yǔ)很重要，不僅僅是處理問(wèn)題的時(shí)候、出錯(cuò)的時(shí)候、分析問(wèn)題的時(shí)候都是英文

到此這篇關(guān)于SpringBoot啟動(dòng)失敗Application run failed的解決辦法的文章就介紹到這了,更多相關(guān)SpringBoot啟動(dòng)失敗Application run failed內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: