一、為什么需要手動(dòng)設(shè)置啟動(dòng)端口？

默認(rèn)情況下，Spring Boot 應(yīng)用會(huì)使用 8080 端口啟動(dòng)。但在以下場(chǎng)景中，我們必須自定義端口：

• 多個(gè)微服務(wù)同時(shí)運(yùn)行，需避免端口沖突；
• 團(tuán)隊(duì)協(xié)作開發(fā)，統(tǒng)一規(guī)范不同服務(wù)的端口號(hào)；
• 測(cè)試負(fù)載均衡或集群部署；
• CI/CD 環(huán)境下動(dòng)態(tài)傳入端口；
• 調(diào)試時(shí)快速切換配置而不修改源碼。

二、四種主流方式

方法一：通過配置文件設(shè)置端口（推薦用于常規(guī)開發(fā)）

這是最基礎(chǔ)也是最常用的配置方式，適用于 Spring Boot 項(xiàng)目。

支持的配置文件類型

操作步驟

打開你的項(xiàng)目資源目錄：

src/main/resources/

編輯 application.properties 文件，添加如下內(nèi)容：

server.port=8081

或者編輯 application.yml 文件：

server:
  port: 8081

保存文件后直接運(yùn)行主類即可生效。

注意事項(xiàng)

• 若未指定端口，默認(rèn)使用 8080。
• 配置文件中的設(shè)置會(huì)被更高優(yōu)先級(jí)的方式覆蓋（見后文“優(yōu)先級(jí)”章節(jié)）。
• 推薦使用 .yml 格式以支持多 profile 配置（如 application-dev.yml, application-prod.yml）。

最佳實(shí)踐

# application.yml 示例：根據(jù)不同環(huán)境設(shè)置端口
spring:
  profiles:
    active: dev

---
spring:
  config:
    activate:
      on-profile: dev
server:
  port: 8081

---
spring:
  config:
    activate:
      on-profile: test
server:
  port: 9090

然后在運(yùn)行配置中添加程序參數(shù)：--spring.profiles.active=test

方法二：通過 VM Options 設(shè)置端口（適合臨時(shí)調(diào)試與多實(shí)例）

當(dāng)你要在同一臺(tái)機(jī)器上啟動(dòng)多個(gè)相同服務(wù)實(shí)例時(shí)，VM Options 是最實(shí)用的方式。

關(guān)鍵點(diǎn)：新版 IDEA 默認(rèn)隱藏部分高級(jí)選項(xiàng)，必須手動(dòng)開啟！

完整操作流程（含界面細(xì)節(jié)）

點(diǎn)擊右上角運(yùn)行配置下拉框 → 選擇 Edit Configurations…

在左側(cè)選擇你的運(yùn)行配置（通常是 Spring Boot 類型）

查找右側(cè)是否有 “VM options:” 輸入框：

• 如果沒有，請(qǐng)點(diǎn)擊下方按鈕：Modify Options
• 彈出菜單后勾選 Add VM options

此時(shí)會(huì)出現(xiàn)輸入框，在其中填寫：

-Dserver.port=8082

點(diǎn)擊 Apply → OK

啟動(dòng)項(xiàng)目，查看控制臺(tái)輸出確認(rèn)端口已變更：

Tomcat started on port(s): 8082 (http)

新版 IDEA 界面提示（文字版）

• “Modify Options” 按鈕位于配置面板底部，圖標(biāo)為齒輪或三個(gè)點(diǎn)。
• 勾選后，“VM options” 字段自動(dòng)出現(xiàn)，支持 -Dkey=value 形式的 JVM 參數(shù)注入。

使用場(chǎng)景舉例

可復(fù)制多個(gè)運(yùn)行配置，分別設(shè)置不同端口，實(shí)現(xiàn)一鍵并行啟動(dòng)。

方法三：通過 Program Arguments 設(shè)置端口（命令行風(fēng)格）

與 VM Options 不同，這種方式是將參數(shù)傳遞給應(yīng)用程序本身，而非 JVM。

如何添加？

1. 進(jìn)入 Run/Debug Configurations
2. 點(diǎn)擊 Modify Options
3. 勾選 Program arguments
4. 輸入：

--server.port=8084

與 VM Options 的區(qū)別對(duì)比

注：兩者均可被 Spring Boot 正確解析，但 -D 方式更底層，可用于非 Spring 項(xiàng)目。

方法四：通過環(huán)境變量設(shè)置端口（適合生產(chǎn)模擬與自動(dòng)化）

某些云平臺(tái)或容器化部署依賴環(huán)境變量來決定端口（如 Kubernetes、Docker）。

在 IDEA 中模擬環(huán)境變量

1. 進(jìn)入 Run Configuration
2. 點(diǎn)擊 Modify Options
3. 勾選 Environment variables
4. 添加鍵值對(duì)：
   • Key: SERVER_PORT
   • Value: 8085

或者寫成一行：

SERVER_PORT=8085;JAVA_OPTS=-Xmx512m

提示：Spring Boot 自動(dòng)映射 SERVER_PORT 到 server.port

實(shí)際應(yīng)用場(chǎng)景

# Docker 啟動(dòng)時(shí)指定
docker run -e SERVER_PORT=8086 my-spring-app

在本地 IDEA 中提前測(cè)試該行為，可極大提升部署穩(wěn)定性。

三、四大方式優(yōu)先級(jí)

Spring Boot 對(duì)端口配置有明確的優(yōu)先級(jí)順序，了解這一點(diǎn)至關(guān)重要：

記憶口訣：“外 > 內(nèi)，動(dòng) > 靜” —— 外部傳入 > 內(nèi)部寫死；動(dòng)態(tài)傳參 > 靜態(tài)配置

四、進(jìn)階：多實(shí)例并行啟動(dòng)（Compound Configuration）

當(dāng)你需要一次性啟動(dòng)多個(gè)不同端口的服務(wù)（例如訂單服務(wù) + 用戶服務(wù) + 網(wǎng)關(guān)），可以使用 Compound Configuration 功能。

操作步驟

1. 打開 Edit Configurations
2. 點(diǎn)擊左上角 + 號(hào) → 選擇 Compound
3. 命名（如：Microservices Cluster）
4. 在 Included configurations 中添加多個(gè)已有的運(yùn)行配置
5. 每個(gè)子配置可獨(dú)立設(shè)置端口（通過 VM Options）
6. 點(diǎn)擊運(yùn)行按鈕，所有服務(wù)將按順序啟動(dòng)

優(yōu)勢(shì)

• 一鍵啟動(dòng)整個(gè)微服務(wù)體系；
• 支持跨模塊聯(lián)合調(diào)試；
• 提升團(tuán)隊(duì)協(xié)作效率。

五、常見問題與解決方案

Q1：?jiǎn)?dòng)時(shí)報(bào)錯(cuò) Address already in use: bind

說明端口已被占用。

解決方案：

Windows:

netstat -ano | findstr :8081
taskkill /PID <進(jìn)程ID> /F

macOS/Linux:

lsof -i :8081
kill -9 <PID>

Q2：VM Options 選項(xiàng)找不到？

原因：新版 IDEA 默認(rèn)隱藏。

正確做法：

• 必須先進(jìn)入 Modify Options
• 主動(dòng)勾選 Add VM options

Q3：端口改了但沒生效？

檢查：

1. 是否拼錯(cuò)關(guān)鍵字（應(yīng)為 server.port，不是 port.server）
2. 是否有多個(gè)配置文件沖突
3. 是否使用了 Profile 激活了另一個(gè)配置
4. 控制臺(tái)日志是否顯示最終使用的端口

六、各方法適用場(chǎng)景總結(jié)

七、技術(shù)延伸

Spring Boot 使用 PropertySource 層次結(jié)構(gòu)加載配置，形成一個(gè)有序的“配置棧”。你可以通過以下代碼驗(yàn)證當(dāng)前生效的端口來源：

@RestController
public class PortInfoController {

    @Value("${server.port}")
    private int port;

    @Autowired
    private Environment env;

    @GetMapping("/port")
    public Map<String, Object> getPortInfo() {
        Map<String, Object> info = new HashMap<>();
        info.put("currentPort", port);
        info.put("propertySources", Arrays.toString(env.getPropertySources().stream()
            .map(EnumerablePropertySource::getName)
            .toArray()));
        return info;
    }
}

訪問 /port 接口即可看到哪些配置源參與了決策。

以上就是IntelliJ IDEA啟動(dòng)項(xiàng)目時(shí)配置端口的操作指南的詳細(xì)內(nèi)容，更多關(guān)于IDEA啟動(dòng)項(xiàng)目配置端口的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！