在 Java 開發(fā)中，配置文件路徑的正確設(shè)置是項(xiàng)目正常運(yùn)行的關(guān)鍵 —— 若路徑寫錯(cuò)，會(huì)導(dǎo)致 “配置文件找不到” 的錯(cuò)誤(如FileNotFoundException)，尤其 JavaWeb 項(xiàng)目因部署環(huán)境特殊，路徑設(shè)置更易踩坑。小編將分別拆解普通 Java 項(xiàng)目與 JavaWeb 項(xiàng)目的配置文件路徑寫法，結(jié)合實(shí)例說明設(shè)置技巧與常見問題，助你精準(zhǔn)定位配置文件。

　　一、普通 Java 項(xiàng)目：配置文件路徑寫法

　　普通 Java 項(xiàng)目(如控制臺(tái)程序、Swing 項(xiàng)目)的配置文件通常放在src/main/resources目錄下(Maven/Gradle 項(xiàng)目標(biāo)準(zhǔn)結(jié)構(gòu))，或src目錄下(非構(gòu)建工具項(xiàng)目)，路徑寫法分為 “相對(duì)路徑” 和 “絕對(duì)路徑” 兩類，核心是基于 “類加載器路徑” 或 “當(dāng)前工作目錄” 定位文件。

　　1. 相對(duì)路徑：基于類加載器或當(dāng)前工作目錄

　　相對(duì)路徑無需寫完整路徑，僅需寫配置文件相對(duì)于 “類加載器根路徑” 或 “項(xiàng)目運(yùn)行目錄” 的位置，是最常用的寫法。

　　(1)基于類加載器的相對(duì)路徑(推薦)

　　類加載器(ClassLoader)的根路徑對(duì)應(yīng)src/main/resources目錄(Maven 項(xiàng)目)，配置文件放在該目錄下時(shí)，可直接通過類加載器讀取，路徑寫法為 “配置文件名。后綴”，無需額外目錄層級(jí)。

　　示例：在src/main/resources下創(chuàng)建config.properties，讀取代碼如下：

　　java取消自動(dòng)換行復(fù)制

　　路徑寫法："config.properties"(直接寫文件名，類加載器自動(dòng)從resources目錄查找);

　　若配置文件放在resources下的子目錄(如resources/config/db.properties)，路徑需包含子目錄："config/db.properties"。

　　(2)基于當(dāng)前工作目錄的相對(duì)路徑(需謹(jǐn)慎)

　　當(dāng)前工作目錄(user.dir)是項(xiàng)目運(yùn)行時(shí)的根目錄(如 IDEA 中默認(rèn)是項(xiàng)目根目錄)，配置文件放在項(xiàng)目根目錄下時(shí)，路徑寫法為 “配置文件名。后綴”。

　　示例：在項(xiàng)目根目錄下創(chuàng)建app.properties，讀取代碼如下：

　　java取消自動(dòng)換行復(fù)制

　　import java.io.FileInputStream;

　　import java.util.Properties;　　

　　public class ReadAppConfig {

　　public static void main(String[] args) throws Exception {

　　// 當(dāng)前工作目錄路徑：System.getProperty("user.dir")

　　String path = "app.properties"; // 相對(duì)于項(xiàng)目根目錄

　　Properties props = new Properties();

　　props.load(new FileInputStream(path));

　　System.out.println("應(yīng)用名稱：" + props.getProperty("app.name"));

　　}

　　}

　　注意：當(dāng)前工作目錄可能因運(yùn)行環(huán)境變化(如打包成 JAR 后運(yùn)行目錄改變)，導(dǎo)致路徑失效，不推薦用于需打包部署的項(xiàng)目。

　　2. 絕對(duì)路徑：寫完整系統(tǒng)路徑(不推薦)

　　絕對(duì)路徑是配置文件在操作系統(tǒng)中的完整路徑(如C:\java-project\config.properties、/home/user/config.properties)，寫法固定但靈活性差，僅適合本地測(cè)試，不適合跨環(huán)境部署。

　　示例：

　　java取消自動(dòng)換行復(fù)制

　　// Windows絕對(duì)路徑

　　String windowsPath = "C:\\java-project\\src\\main\\resources\\config.properties";

　　// Linux/macOS絕對(duì)路徑

　　String linuxPath = "/home/user/java-project/src/main/resources/config.properties";

　　問題：換電腦或部署到服務(wù)器時(shí)，路徑需重新修改，維護(hù)成本高，生產(chǎn)環(huán)境禁用。

　　二、JavaWeb 項(xiàng)目：配置文件路徑設(shè)置

　　JavaWeb 項(xiàng)目(如 SSM、Spring Boot 項(xiàng)目)需部署到 Tomcat 等服務(wù)器，配置文件路徑設(shè)置與普通 Java 項(xiàng)目不同，核心是基于 “類路徑(WEB-INF/classes)” 或 “Web 應(yīng)用根目錄(WEB-INF同級(jí)目錄)” 定位，且需通過 Servlet API 或框架工具類讀取。

　　1. 類路徑下的配置文件(WEB-INF/classes)

　　JavaWeb 項(xiàng)目編譯后，src/main/resources目錄下的配置文件會(huì)自動(dòng)復(fù)制到WEB-INF/classes目錄(類路徑根目錄)，讀取方式與普通 Java 項(xiàng)目類似，但需通過 Web 環(huán)境的類加載器(如ServletContext)讀取。

　　(1)Servlet 中讀取(原生 Servlet)

　　java取消自動(dòng)換行復(fù)制

　　import javax.servlet.ServletException;

　　import javax.servlet.http.HttpServlet;

　　import javax.servlet.http.HttpServletRequest;

　　import javax.servlet.http.HttpServletResponse;

　　import java.io.IOException;

　　import java.io.InputStream;

　　import java.util.Properties;

　　public class ConfigServlet extends HttpServlet {

　　@Override

　　protected void doGet(HttpServletRequest req, HttpServletResponse resp)

　　throws ServletException, IOException {

　　try {

　　// 1. 通過ServletContext獲取類路徑下的配置文件輸入流

　　InputStream is = getServletContext()

　　.getResourceAsStream("/WEB-INF/classes/config.properties");

　　// 2. 加載配置

　　Properties props = new Properties();

　　props.load(is);

　　resp.getWriter().write("數(shù)據(jù)庫地址：" + props.getProperty("db.url"));

　　} catch (Exception e) {

　　e.printStackTrace();

　　}

　　}

　　}

　　路徑寫法："/WEB-INF/classes/config.properties"(/表示 Web 應(yīng)用根目錄，WEB-INF/classes是類路徑根目錄);

　　簡(jiǎn)化寫法：若通過類加載器讀取，路徑與普通 Java 項(xiàng)目一致(無需寫WEB-INF/classes)：

　　java取消自動(dòng)換行復(fù)制

　　InputStream is = ConfigServlet.class.getClassLoader()

　　.getResourceAsStream("config.properties");

　　(2)Spring 框架中讀取(SSM/Spring Boot)

　　Spring 框架提供ClassPathResource工具類，可直接讀取類路徑下的配置文件，無需關(guān)注 Web 環(huán)境細(xì)節(jié)：

　　java取消自動(dòng)換行復(fù)制

　　import org.springframework.core.io.ClassPathResource;

　　import java.io.InputStream;

　　import java.util.Properties;

　　public class SpringConfigReader {

　　public void readConfig() throws Exception {

　　// 路徑寫法：直接寫類路徑下的文件名

　　ClassPathResource resource = new ClassPathResource("config.properties");

　　InputStream is = resource.getInputStream();

　　Properties props = new Properties();

　　props.load(is);

　　System.out.println("服務(wù)器端口：" + props.getProperty("server.port"));

　　}

　　}

　　若配置文件在類路徑子目錄(如resources/spring/applicationContext.xml)，路徑寫法："spring/applicationContext.xml"。

　　2. Web 應(yīng)用根目錄下的配置文件(WEB-INF同級(jí))

　　若配置文件放在 Web 應(yīng)用根目錄(與WEB-INF同級(jí)，如config/app.properties)，需通過ServletContext的getResourceAsStream讀取，路徑以/開頭(表示 Web 應(yīng)用根目錄)。

　　示例：

　　java取消自動(dòng)換行復(fù)制

　　// 配置文件路徑：Web應(yīng)用根目錄/config/app.properties

　　InputStream is = getServletContext()

　　.getResourceAsStream("/config/app.properties");

　　注意：Web 應(yīng)用根目錄下的文件可通過瀏覽器直接訪問(如http://localhost:8080/myweb/config/app.properties)，敏感配置(如數(shù)據(jù)庫密碼)禁止放在此處，需放在WEB-INF目錄下(瀏覽器無法直接訪問)。

　　3. Spring Boot 項(xiàng)目的特殊路徑(簡(jiǎn)化配置)

　　Spring Boot 項(xiàng)目通過 “約定優(yōu)于配置” 簡(jiǎn)化路徑設(shè)置，配置文件(如application.properties/application.yml)默認(rèn)放在以下路徑(優(yōu)先級(jí)從高到低)：

　　file:./config/(項(xiàng)目根目錄下的config目錄);

　　file:./(項(xiàng)目根目錄);

　　classpath:/config/(類路徑下的config目錄);

　　classpath:/(類路徑根目錄)。

　　路徑寫法：無需手動(dòng)設(shè)置路徑，Spring Boot 自動(dòng)掃描上述目錄的配置文件，直接通過@Value或@ConfigurationProperties注入配置即可：

　　java取消自動(dòng)換行復(fù)制

　　import org.springframework.beans.factory.annotation.Value;

　　import org.springframework.web.bind.annotation.GetMapping;

　　import org.springframework.web.bind.annotation.RestController;　

　　@RestController

　　public class ConfigController {

　　@Value("${server.port}")

　　private int port;

　　@GetMapping("/port")

　　public String getPort() {

　　return "服務(wù)器端口：" + port;

　　}

　　}

　　三、常見問題與避坑技巧

　　路徑中斜杠(/)的使用

　　類加載器讀取時(shí)：路徑開頭不加/(如"config.properties")，加/會(huì)報(bào)錯(cuò);

　　ServletContext讀取時(shí)：路徑開頭需加/(如"/WEB-INF/classes/config.properties")，表示 Web 應(yīng)用根目錄。

　　打包后配置文件路徑失效

　　普通 Java 項(xiàng)目打包成 JAR 后，類路徑下的配置文件需通過ClassLoader.getResourceAsStream讀取，不能用FileInputStream(JAR 內(nèi)文件無法用文件路徑訪問);

　　JavaWeb 項(xiàng)目打包成 WAR 后，WEB-INF/classes下的配置文件需通過類加載器或ServletContext讀取，避免用絕對(duì)路徑。

　　多環(huán)境配置文件路徑

　　可通過 “目錄區(qū)分” 設(shè)置多環(huán)境路徑(如resources/dev/config.properties、resources/prod/config.properties)，讀取時(shí)指定環(huán)境目錄："dev/config.properties";

　　Spring Boot 項(xiàng)目直接通過spring.profiles.active=dev指定環(huán)境，無需手動(dòng)設(shè)置路徑。

　　Java 配置文件路徑寫法的核心是 “基于類路徑”，普通 Java 項(xiàng)目?jī)?yōu)先用類加載器讀取resources目錄下的相對(duì)路徑，避免絕對(duì)路徑;JavaWeb 項(xiàng)目需區(qū)分 “類路徑(WEB-INF/classes)” 與 “Web 應(yīng)用根目錄”，敏感配置放在WEB-INF下，通過ServletContext或框架工具類讀取;Spring Boot 項(xiàng)目利用約定路徑簡(jiǎn)化配置，無需手動(dòng)設(shè)置復(fù)雜路徑。