Windows系统下Java程序启动脚本编写指南

一、为什么需要Java启动脚本？

在Windows环境下运行Java程序时，直接使用命令行启动虽然简单，但存在不少问题。每次启动都要输入一长串命令，参数容易输错，程序关闭后无法自动重启，日志管理也不方便。编写一个专业的启动脚本，能帮你解决这些烦恼。

启动脚本的主要作用有：

简化启动流程：双击脚本就能运行程序，无需记忆复杂命令
统一管理配置：集中设置JVM参数、程序参数
自动化运维：实现自动重启、日志轮转、状态监控
错误处理：程序异常退出时能及时通知并恢复

二、基础版启动脚本（适合新手）

如果你是Java初学者，这个基础脚本能满足大部分简单需求。

2.1 最简单的启动脚本

创建一个文本文件，命名为start.bat，用记事本打开并输入以下内容：

@echo off
echo 正在启动Java程序...
java -jar myapp.jar
pause

使用步骤：

将上面的代码保存为start.bat
把myapp.jar改成你实际的jar包名称
将脚本和jar包放在同一目录下
双击start.bat即可运行

2.2 带基本参数的脚本

如果程序需要一些基本配置，可以这样写：

@echo off
chcp 65001 > nul
set APP_NAME=myapp.jar
set JAVA_OPTS=-Xms256m -Xmx512m

echo ========================================
echo     Java程序启动脚本
echo     程序名称: %APP_NAME%
echo     启动时间: %date% %time%
echo ========================================

java %JAVA_OPTS% -jar "%APP_NAME%"

if %errorlevel% neq 0 (
    echo 程序异常退出，退出代码: %errorlevel%
) else (
    echo 程序正常退出
)

pause

参数说明：

chcp 65001：设置控制台编码为UTF-8，解决中文乱码
Xms256m：Java堆内存初始大小256MB
Xmx512m：Java堆内存最大512MB
%errorlevel%：获取程序退出状态码

三、进阶版启动脚本（含实用功能）

当你需要更多功能时，可以使用这个增强版脚本。

3.1 完整功能脚本

创建start_advanced.bat，内容如下：

@echo off
setlocal enabledelayedexpansion

rem ========== 基础配置 ==========
set APP_NAME=myapplication.jar
set APP_HOME=%~dp0
set LOG_DIR=%APP_HOME%logs
set PID_FILE=%APP_HOME%app.pid

rem ========== JVM参数配置 ==========
set JAVA_OPTS=-Xms512m -Xmx1024m ^
              -XX:+UseG1GC ^
              -XX:+HeapDumpOnOutOfMemoryError ^
              -XX:HeapDumpPath="%LOG_DIR%\heapdump.hprof" ^
              -Dfile.encoding=UTF-8 ^
              -Duser.timezone=Asia/Shanghai

rem ========== 程序参数配置 ==========
set APP_OPTS=--spring.profiles.active=prod ^
             --server.port=8080

rem ========== 检查Java环境 ==========
where java >nul 2>nul
if %errorlevel% neq 0 (
    echo [错误] 未找到Java环境，请先安装JDK
    pause
    exit /b 1
)

rem ========== 创建日志目录 ==========
if not exist "%LOG_DIR%" mkdir "%LOG_DIR%"

rem ========== 检查是否已运行 ==========
if exist "%PID_FILE%" (
    for /f "tokens=1" %%i in (%PID_FILE%) do (
        tasklist /fi "PID eq %%i" | find "java" >nul
        if !errorlevel! equ 0 (
            echo [警告] 程序已在运行，PID: %%i
            pause
            exit /b 0
        )
    )
)

rem ========== 启动程序 ==========
echo [信息] 启动时间: %date% %time%
echo [信息] 程序目录: %APP_HOME%
echo [信息] JVM参数: %JAVA_OPTS%
echo [信息] 程序参数: %APP_OPTS%

java %JAVA_OPTS% -jar "%APP_HOME%%APP_NAME%" %APP_OPTS% ^
    1>"%LOG_DIR%\app_%date:~0,4%%date:~5,2%%date:~8,2%.log" ^
    2>"%LOG_DIR%\error_%date:~0,4%%date:~5,2%%date:~8,2%.log" &
echo %!> "%PID_FILE%"

echo [信息] 程序已启动，PID: %! 
echo [信息] 日志文件: %LOG_DIR%\app_*.log
echo [信息] 按Ctrl+C可停止程序

:wait
timeout /t 1 /nobreak >nul
tasklist /fi "PID eq %!" | find "java" >nul
if %errorlevel% equ 0 goto wait

echo [信息] 程序已停止
if exist "%PID_FILE%" del "%PID_FILE%"
pause

3.2 配套的停止脚本

创建stop.bat用于停止程序：

@echo off
set APP_HOME=%~dp0
set PID_FILE=%APP_HOME%app.pid

if not exist "%PID_FILE%" (
    echo [错误] 未找到PID文件，程序可能未运行
    pause
    exit /b 1
)

for /f "tokens=1" %%i in (%PID_FILE%) do (
    echo [信息] 正在停止进程: %%i
    taskkill /f /pid %%i >nul 2>nul
    if %errorlevel% equ 0 (
        echo [信息] 进程已停止
    ) else (
        echo [警告] 停止进程失败
    )
)

if exist "%PID_FILE%" del "%PID_FILE%"
echo [信息] 清理完成
pause

四、专业版服务化脚本（适合生产环境）

对于需要长期运行的服务，建议注册为Windows服务。

4.1 使用WinSW将Java程序注册为服务

WinSW是一个开源工具，可以将任何程序包装成Windows服务。

步骤1：下载WinSW

访问GitHub搜索"WinSW"
下载WinSW-x64.exe（64位系统）或WinSW-x86.exe（32位系统）
重命名为myapp-service.exe

步骤2：创建配置文件 创建myapp-service.xml：

<service>
    <id>myapp-service</id>
    <name>My Java Application</name>
    <description>我的Java应用程序服务</description>

    <executable>java</executable>
    <arguments>
        -Xms512m -Xmx1024m 
        -XX:+UseG1GC 
        -jar "%~dp0myapp.jar" 
        --server.port=8080
    </arguments>

    <log mode="roll-by-size">
        <sizeThreshold>10240</sizeThreshold>
        <keepFiles>8</keepFiles>
    </log>

    <onfailure action="restart" delay="10 sec"/>
    <serviceaccount>
        <domain>.</domain>
        <user>LocalSystem</user>
        <allowservicelogon>true</allowservicelogon>
    </serviceaccount>
</service>

步骤3：安装和管理服务

rem 安装服务
myapp-service.exe install

rem 启动服务
myapp-service.exe start

rem 停止服务
myapp-service.exe stop

rem 卸载服务
myapp-service.exe uninstall

rem 查看状态
myapp-service.exe status

4.2 使用NSSM（另一种服务管理工具）

NSSM更简单易用，有图形界面。

安装步骤：

下载NSSM，解压到任意目录
打开命令提示符，进入NSSM目录
执行：nssm install MyJavaApp
在弹出的窗口中配置：
- Path: java.exe的完整路径
- Startup directory: 你的jar包所在目录
- Arguments: -jar myapp.jar --server.port=8080

五、常见问题与解决方案

5.1 中文乱码问题

问题现象： 控制台输出中文显示为乱码。

解决方案：

rem 方法1：设置控制台编码
chcp 65001 > nul

rem 方法2：启动时指定编码
java -Dfile.encoding=UTF-8 -jar myapp.jar

rem 方法3：修改注册表（永久生效）
reg add HKCU\Console /v CodePage /t REG_DWORD /d 65001 /f

5.2 内存溢出问题

问题现象： 程序运行一段时间后崩溃，提示OutOfMemoryError。

解决方案：

rem 增加堆内存大小
set JAVA_OPTS=-Xms1g -Xmx2g ^
              -XX:MaxMetaspaceSize=256m

rem 启用内存溢出时自动转储
set JAVA_OPTS=%JAVA_OPTS% ^
              -XX:+HeapDumpOnOutOfMemoryError ^
              -XX:HeapDumpPath=./heapdump.hprof

rem 调整GC策略
set JAVA_OPTS=%JAVA_OPTS% ^
              -XX:+UseG1GC ^
              -XX:MaxGCPauseMillis=200

5.3 程序无法在后台运行

问题现象： 关闭命令行窗口后程序也退出了。

解决方案：

rem 方法1：使用start命令
start "MyApp" java -jar myapp.jar

rem 方法2：使用javaw（无控制台窗口）
javaw -jar myapp.jar

rem 方法3：使用vbs脚本后台运行
rem 创建run.vbs，内容如下：
Set ws = CreateObject("Wscript.Shell")
ws.run "java -jar myapp.jar",0

5.4 日志文件过大

问题现象： 日志文件不断增长，占用大量磁盘空间。

解决方案：

rem 在脚本中添加日志轮转功能
set LOG_FILE=app.log
set MAX_SIZE=10485760  rem 10MB

if exist "%LOG_FILE%" (
    for %%F in ("%LOG_FILE%") do (
        if %%~zF gtr %MAX_SIZE% (
            ren "%LOG_FILE%" "app_%date:~0,4%%date:~5,2%%date:~8,2%%time:~0,2%%time:~3,2%.log"
        )
    )
)

java -jar myapp.jar >> "%LOG_FILE%" 2>&1