acepanel.github.io/zh_TW/advanced/project/java.md

Java 專案

Java 專案用於部署 Spring Boot、Tomcat 等 Java 應用。

前置要求

1. 安裝 Java 執行環境：應用 > 執行環境 > Java（Corretto JDK）
2. 打包好的 JAR 檔案或 WAR 檔案

部署 Spring Boot 應用

打包專案

# Maven
mvn clean package -DskipTests

# Gradle
./gradlew build -x test

上傳並部署

1. 上傳 JAR 檔案到伺服器（如 /opt/ace/project/myapp/app.jar）
2. 建立專案：
   • 專案名：myapp
   • 專案目錄：/opt/ace/project/myapp
   • 啟動命令：java21 -jar app.jar
3. 開啟 反向代理

啟動命令範例

# 基本啟動
java21 -jar app.jar

# 指定配置檔案
java21 -jar app.jar --spring.profiles.active=prod

# 設定 JVM 參數
java21 -Xms512m -Xmx1024m -jar app.jar

# 指定連接埠
java21 -jar app.jar --server.port=8080

JVM 參數建議

# 生產環境推薦配置
java21 \
  -Xms512m \
  -Xmx1024m \
  -XX:+UseG1GC \
  -XX:MaxGCPauseMillis=200 \
  -jar app.jar

常用參數說明：

參數	說明
-Xms	初始堆積記憶體大小
-Xmx	最大堆積記憶體大小
-XX:+UseG1GC	使用 G1 垃圾收集器
-XX:MaxGCPauseMillis	最大 GC 停頓時間

多版本 JDK

AcePanel 支援安裝多個 JDK 版本，路徑如 /opt/ace/server/java/{version}/bin/java，已預設連結 java{version} 命令方便使用。

配置檔案

Spring Boot 配置檔案 application.yml 範例：

server:
  port: 8080

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: root
    password: your_password

常見問題

記憶體不足

增加 JVM 堆積記憶體：

java21 -Xms1g -Xmx2g -jar app.jar

連接埠衝突

修改啟動連接埠：

java21 -jar app.jar --server.port=8081

啟動慢

檢查是否有外部依賴連線逾時，或新增以下參數加速啟動：

-XX:TieredStopAtLevel=1 -noverify