Java 圖片加載「無效地址」錯誤原因與解決：路徑配置詳解

問題現象

在 Java 項目（特別是 Web 項目）中使用相對路徑加載圖片時，控制台報錯「加載無效的地址」，圖片無法顯示。錯誤截圖顯示路徑為 https://code.yunyiwangluo.com/bianchen/UploadFiles_4619/201701/2017010518290918.png，這是模板佔位符，非真實路徑。

核心原因

圖片未放置在項目部署路徑下，或路徑寫法錯誤。 Java Web 項目中，靜態資源（圖片、CSS、JS）必須放在 src/main/webapp（Maven 結構）或 WebContent 目錄下，且引用時需使用相對於部署根目錄的路徑。

解決方案

1. 確認圖片物理位置：將圖片複製到項目部署目錄，例如 webapp/images/photo.png。
2. 正確引用路徑：
   • JSP/HTML 中：<img src="images/photo.png">（相對路徑）或 <img src="${pageContext.request.contextPath}/images/photo.png">（絕對路徑，推薦）。
   • Java 代碼中讀取：使用 getServletContext().getRealPath("/images/photo.png") 獲取絕對磁盤路徑。
3. 檢查部署配置：確保 IDE（Eclipse/MyEclipse/IDEA）的部署設置將靜態資源目錄映射到應用根目錄。

常見誤區

• 將圖片放在 src/main/java 或 WEB-INF 下：這些目錄不對外公開訪問。
• 使用本地絕對路徑（如 D:/project/img.png）：部署到服務器後路徑失效。
• 路徑大小寫不匹配：Linux 服務器區分大小寫。

最佳實踐

建議使用 Spring Boot 等現代框架，將靜態資源放在 src/main/resources/static 或 src/main/resources/public，自動映射到 /static/** 或 /**，無需手動配置路徑。