在 Spring Boot 的 addResourceLocations 方法中，file: 是一個 URL 前綴，用于指示資源的位置是本地文件系統路徑。以下是詳細解釋：

---

一、file: 的作用

file: 是 Java 中用于表示本地文件系統的 URL 前綴。它告訴 Spring Boot，資源的位置是本地磁盤上的某個目錄，而不是類路徑（classpath:）或其他位置。

---

二、為什么需要 file:？

在 Spring Boot 中，addResourceLocations 方法需要明確的資源位置格式。file: 前綴用于區分以下幾種常見的資源位置：

1. 本地文件系統路徑：file:/path/to/directory/
2. 類路徑資源：classpath:/static/
3. HTTP/HTTPS 資源：https://example.com/

如果不加 file:，Spring Boot 會默認將路徑解析為類路徑資源，從而導致無法正確找到文件。

---

三、示例說明

假設上傳的文件存儲在 uploads/avatars/ 目錄下，以下是幾種資源位置的寫法：

1. 絕對路徑（推薦）：

   registry.addResourceHandler("/image/useravatar/**").addResourceLocations("file:/absolute/path/to/uploads/avatars/");
   

2. 相對路徑：

   registry.addResourceHandler("/image/useravatar/**").addResourceLocations("file:uploads/avatars/");
   

   ? 相對路徑是基于項目運行時的當前工作目錄（通常是項目的根目錄）。

3. 類路徑資源：

   registry.addResourceHandler("/image/useravatar/**").addResourceLocations("classpath:/static/avatars/");
   

---

四、file: 的注意事項

1. 路徑分隔符
   ? 在 Windows 系統中，路徑分隔符為 \，但 file: 要求使用 /。
   ? 示例：

   registry.addResourceHandler("/image/useravatar/**").addResourceLocations("file:C:/path/to/uploads/avatars/");
   

2. 路徑結尾斜杠
   ? 確保路徑以 / 結尾，否則 Spring Boot 可能無法正確解析。

3. 跨平臺兼容性
   ? 使用 Paths.get() 或 System.getProperty("user.dir") 動態獲取路徑，確保跨平臺兼容性：

   String uploadDir = Paths.get("uploads/avatars").toAbsolutePath().toString();
   registry.addResourceHandler("/image/useravatar/**").addResourceLocations("file:" + uploadDir + "/");
   

---

五、完整示例

以下是一個完整的 Spring Boot 配置示例：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import java.nio.file.Paths;@Configuration
public class WebConfig implements WebMvcConfigurer {@Overridepublic void addResourceHandlers(ResourceHandlerRegistry registry) {// 獲取上傳目錄的絕對路徑String uploadDir = Paths.get("uploads/avatars").toAbsolutePath().toString();// 配置虛擬路徑映射registry.addResourceHandler("/image/useravatar/**").addResourceLocations("file:" + uploadDir + "/");}
}

---

六、總結

? file: 是用于指示本地文件系統路徑的 URL 前綴。
? 在 Spring Boot 中，使用 file: 可以確保資源位置被正確解析為本地磁盤路徑。
? 建議使用絕對路徑，并確保路徑以 / 結尾，以避免跨平臺兼容性問題。

如果仍有疑問，可以提供更多上下文信息，我會進一步協助！