### 歡迎訪問我的GitHub
> 這裡分類和彙總了欣宸的全部原創(含配套原始碼)：[https://github.com/zq2599/blog_demos](https://github.com/zq2599/blog_demos)

### 問題簡述
- 透過Jib外掛將SpringBoot工程製作成Docker映象成功，但是執行映象的時候報錯 **(Could not find or load main class ${start-class})** ，今天來一起分析這個問題，希望能幫讀者跳過小坑。
### 關於Jib外掛
- 在Maven工程中可以使用Jib外掛將當前Java工程構建成Docker映象，詳情請參考：
1. [《Docker與Jib(maven外掛版)實戰》](https://blog.csdn.net/boling_cavalry/article/details/94355659);
2. [《Jib使用小結(Maven外掛版)》](https://blog.csdn.net/boling_cavalry/article/details/100179709);
### 環境資訊
1. 作業系統：macOS Mojave 10.14.6 (18G103)
2. JDK：10.14.6 (18G103)
3. Docker：10.14.6 (18G103)
4. SpringBoot：2.1.8.RELEASE
5. Jib外掛版本：1.6.1
### 原始碼下載
- 為了重現問題，我將出現問題的SpringBoot工程上傳到GitHub，地址和連結資訊如下表所示：

| 名稱      |   連結 |   備註|
| :-------- | :----| :----|
| 專案主頁| https://github.com/zq2599/blog_demos | 該專案在GitHub上的主頁 |
| git倉庫地址(https)| https://github.com/zq2599/blog_demos.git | 該專案原始碼的倉庫地址，https協議 |
| git倉庫地址(ssh)| git@github.com:zq2599/blog_demos.git | 該專案原始碼的倉庫地址，ssh協議 |

- 這個git專案中有多個資料夾，本章的應用在jib-error-demo資料夾下，如下圖紅框所示：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190929000351485.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
### 問題：
- 在pom.xml檔案所在目錄執行命令 **mvn clean compile -U** ，映象可以構建成功，但是控制檯輸出了警告資訊，如下圖：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190928215342191.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 嘗試用此映象建立容器，行命令 **docker run --name=test bolingcavalry/hellojib:0.0.1-SNAPSHOT** ，報錯如下：
```shell
CN0014005932:~ zhaoqin$ docker run --name=test bolingcavalry/hellojib:0.0.1-SNAPSHOT
Error: Could not find or load main class ${start-class}
```
-  **docker ps -a** 檢視容器資訊如下，只能看到狀態是"退出"，別的沒啥了：
```shell
CN0014005932:~ zhaoqin$ docker ps -a
CONTAINER ID        IMAGE                                   COMMAND                  CREATED             STATUS                     PORTS               NAMES
d618f6588821        bolingcavalry/hellojib:0.0.1-SNAPSHOT   "java -Xms4g -Xmx4g …"   4 minutes ago       Exited (1) 4 minutes ago                       test
```
- 不甘心，用命令 **docker ps -a --no-trunc** 檢視未截斷的容器資訊：
```shell
CN0014005932:~ zhaoqin$ docker ps -a --no-trunc
CONTAINER ID                                                       IMAGE                                   COMMAND                                                                           CREATED             STATUS                     PORTS               NAMES
d618f6588821f00d3bd0b67a85ff92988b90dfff710370c9d340d5c544c550af   bolingcavalry/hellojib:0.0.1-SNAPSHOT   "java -Xms4g -Xmx4g -cp /app/resources:/app/classes:/app/libs/* ${start-class}"   7 minutes ago       Exited (1) 7 minutes ago                       test
```
- 這次有新發現，容器啟動時執行命令是 **java -Xms4g -Xmx4g -cp /app/resources:/app/classes:/app/libs/* ${start-class}** ，怪哉！這個 **\${start-class}** 是什麼？我們來看一個正常映象的啟動命令：
```shell
java -Xms4g -Xmx4g -cp /app/resources:/app/classes:/app/libs/* com.bolingcavalry.jiberrordemo.JibErrorDemoApplication
```
- 如上所示， **com.bolingcavalry.jiberrordemo.JibErrorDemoApplication** 是main方法所在類，此命令可以正常執行JibErrorDemoApplication類的main方法；
- 小結問題：容器啟動時執行java命令，把 **\${start-class}** 作為引數傳給java，導致java無法處理此引數，所以程式報錯，導致容器退出；

### 問題原因
- 此問題的原因很簡單： **java工程中帶有main方法的類不止一個** ，去檢視jib-error-demo工程的程式碼，發現Utils.java中果然有個main方法：
```java
public class Utils {

public static String time(){
      return new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()).toString();
    }

public static void main(String[] args){
        System.out.println(time());
    }
}
```
- 將上述main方法刪除掉，再構建映象並執行容器，證實問題已經解決。
### 另一種解決問題的方法
- 如果不想動Utils類的程式碼(也許jar包中某個類帶有main方法)，請開啟pom.xml檔案，在jib外掛的配置中增加 **mainClass** 節點，節點內容是指定的class類，如下圖紅框所示：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190928220510777.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 經過上面的設定，問題也可以解決。

- 接下來，如果您有興趣瞭解更深層次的原因，我們們一起來深度探險吧。
### 查詢問題
- 這個問題在Jib的官方GitHub上是有記錄的，先看第一條，地址是：https://github.com/GoogleContainerTools/jib/issues/1601 ，如下圖紅框所示，同樣的問題，最後issue的發起人自己關閉了這個issue，因為他發現這自己的專案中有兩個帶有main方法的類：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190928201751756.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 再來看看這個issue， https://github.com/GoogleContainerTools/jib/issues/170 ，Jib的作者Q Chen推測是Spring將 **\${start-class}** 這個字串設定為Main-Class屬性的值(個人感覺，這裡說的Spring應該是spring boot的mave外掛吧)，於是Jib外掛在使用Main-Class的值得時候，拿到的就是 **\${start-class}** 這個字串了：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190928202958532.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 170這個issue的後續情節很有意思，Jib作者Q Chen對這個問題也很糾結，如果Java工程中發現了多個帶有main方法的類，Jib究竟該如何處理呢？Q Chen最後決定輸出警告，如下圖：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190928214016699.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 一起來看看這段程式碼吧，也就是上圖中#288，地址是：https://github.com/GoogleContainerTools/jib/pull/228/files/c8757e1f9ea47edd78df18142de7836a68f22034 ，如果mainClass不像一個class類的名稱，就輸出警告，這個邏輯在Gradle和Maven外掛中都寫入了：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190928214341998.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 最後一個問題：上面程式碼中的mainClass從哪來的？開啟上圖的原始碼，地址是：https://github.com/GoogleContainerTools/jib/blob/c8757e1f9ea47edd78df18142de7836a68f22034/jib-maven-plugin/src/main/java/com/google/cloud/tools/jib/maven/BuildImageMojo.java ，如下圖紅框，從方法名可以推測，該值來自構建SpringBoot工程的maven外掛，所以前面Q Chen提到main-class變數的值是Spring修改的，應該是來自這段程式碼：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190928214641595.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 此時的您，如果依然意猶未盡，我們們再來鞏固一下SpringBoot的start-class
### 關於start-class
- 熟悉SpringBoot的同學其實對 **\${start-class}** 並不陌生，當工程中多個類中都有 **main** 方法時，使用該引數來指定SpringBoot的啟動類；
- 先看SpringBoot官方文件熟悉一下 **start-class** ，地址是：https://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/ ，下圖內容比較關鍵：我們設定的啟動類被指定到 **Start-Class** 屬性中，而 **Main-Class** 屬性變成了 **org.springframework.boot.loader.JarLauncher** ，這才是SpringBoot真正的啟動類：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190928193456502.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 如下圖，這是個補充說明， **Main-Class** 屬性的值被轉移到 **Start-Class** 屬性這個動作，是maven外掛在構建jar的時候做的：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190928192155318.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 所以start-class的值是來自main-class，再看main-class的值從哪裡來，如下圖紅框所示，maven外掛會去查詢帶有 **public static void main(String[] args)** 的類：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/2019092819085617.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 至此，Jib構建的映象問題分析完畢，一個小小的問題引發了這麼多學習和探索，雖然有點費時間，但是可以讓人再次感受到"技術是相通的"感覺，不知道您有沒有這種感覺呢？

### 歡迎關注ITpub：程式設計師欣宸
> [學習路上，你不孤單，欣宸原創一路相伴...](http://blog.itpub.net/70017844/)

Jib構建映象問題從定位到深入分析

相關文章