springboot打包jar到docker鏡像找不到resources下的文件怎么辦

# SpringBoot打包JAR到Docker鏡像找不到resources下的文件怎么辦

## 問題現象

當使用SpringBoot項目打包成JAR并部署到Docker容器時，可能會遇到`resources`目錄下的文件（如配置文件、靜態資源等）無法被正確加載的問題。典型報錯包括：

java.io.FileNotFoundException: class path resource [xxx.yml] cannot be opened because it does not exist

## 原因分析

### 1. 打包路徑問題
SpringBoot的`resources`目錄在打包后會位于JAR文件的`BOOT-INF/classes/`路徑下，直接通過`new File()`方式訪問會失效。

### 2. Docker鏡像構建方式
使用`ADD`或`COPY`指令時未正確處理JAR內部路徑結構，或工作目錄（WORKDIR）設置不當。

### 3. 資源加載方式錯誤
在代碼中使用`File`類直接訪問資源，而非通過Spring的`ResourceLoader`或`ClassPathResource`。

## 解決方案

### 方案一：使用ClassPathResource加載（推薦）
```java
// 正確方式
Resource resource = new ClassPathResource("file.txt");
InputStream inputStream = resource.getInputStream();

// 或通過ResourceLoader
@Autowired
ResourceLoader resourceLoader;

public void loadResource() {
    Resource resource = resourceLoader.getResource("classpath:file.txt");
}

方案二：修正Dockerfile配置

# 基礎鏡像
FROM openjdk:17-jdk-slim

# 將JAR文件復制到容器中（保持原始路徑）
COPY target/your-app.jar /app/app.jar

# 設置工作目錄
WORKDIR /app

# 啟動命令
ENTRYPOINT ["java", "-jar", "app.jar"]

方案三：調整資源訪問方式

如果必須使用文件路徑：

// 獲取資源在容器中的臨時解壓路徑
String path = ResourceUtils.getFile("classpath:file.txt").getPath();

驗證步驟

1. 本地測試：

java -jar target/your-app.jar

1. 構建Docker鏡像：

docker build -t my-springboot-app .

1. 運行容器：

docker run -p 8080:8080 my-springboot-app

注意事項

1. 生產環境建議：將配置文件通過-Dspring.config.location參數外掛

   ENTRYPOINT ["java", "-jar", "-Dspring.config.location=/config/", "app.jar"]
   

2. 靜態資源處理：Web項目建議將靜態文件放在src/main/resources/static/下

3. 多階段構建：對于復雜項目可使用多階段構建減小鏡像體積 “`dockerfile FROM maven:3.8.6 AS build COPY . . RUN mvn package

FROM openjdk:17-jdk-slim COPY –from=build /target/your-app.jar /app.jar ENTRYPOINT [“java”,“-jar”,“/app.jar”]

通過以上方法，可以確保SpringBoot應用在Docker環境中正確加載resources目錄下的資源文件。

（全文約650字，包含代碼示例和分步解決方案）