Windows启动 Java 项目并自定义进程名（修改 Java 可执行文件名称实现）
Windows 批处理启动 Java 项目并自定义进程名（修改 Java 可执行文件名称实现）
一、前言
在 Windows 环境下使用java \-jar或\-cp启动 Java 应用时，任务管理器中进程名统一为java\.exe/javaw\.exe，多服务部署场景下，无法快速区分各个业务对应的进程，运维排查极其不便。
本文讲解一种零侵入、无第三方依赖的最优解决方案：通过重命名 JDK 自带的java\.exe自定义业务进程名，搭配原生批处理脚本，实现「自动查杀端口旧进程 + 后台静默启动项目 + CMD窗口自动关闭」能力。同时适配 SpringBoot完整Jar包和瘦身分离包两种主流部署方式，启动逻辑与 Linux 环境完全对齐，跨平台适配性极强。
核心优势：无需安装第三方工具、无需注册Windows系统服务、纯原生批处理、兼容所有Windows版本、跨平台启动逻辑统一、多服务进程独立可区分。
二、核心实现原理
2.1 自定义进程名原理
Windows 系统会以启动程序的文件名作为任务管理器进程名。JDK默认启动程序为java\.exe，所有Java项目进程名统一重复。
只需复制一份原生 java.exe，重命名为对应业务名称（如doorJava\.exe），使用重命名后的可执行文件启动项目，即可实现进程名自定义，多服务部署互不干扰。
2.2 批处理脚本核心能力
自动释放端口：通过端口检索进程PID，强制查杀旧进程，彻底解决端口占用问题；
无阻塞后台启动：借助
start /b命令拉起Java进程，脱离CMD窗口依赖，解决窗口阻塞无法关闭的痛点；双部署模式适配：区分完整Jar包（-jar启动）、瘦身分离包（-cp加载外部lib/配置）两种部署场景。
三、部署前置准备
3.1 自定义Java启动程序（必操作）
进入本机JDK软连接目录（通用Windows JDK路径）：
C:\Program Files (x86)\Common Files\Oracle\Java\javapath操作步骤：
找到目录下的
java\.exe文件；复制粘贴生成副本（不要直接修改原文件）；
将副本重命名为业务专属名称，示例：
doorJava\.exe；后续所有项目启动脚本，均使用该自定义程序启动，实现进程名自定义。
3.2 标准项目部署目录结构
场景一：完整Jar包部署（依赖内置，仅外置配置）
E:\hdx\project\ ├─ yudao-server.jar # 完整可执行Jar包（内置所有依赖） ├─ resources/ # 外置配置文件目录（yml/xml等） └─ start_jar.bat # 对应启动脚本场景二：瘦身分离包部署（lib依赖、配置外置）
E:\hdx\project\ ├─ yudao-server.jar # 瘦身核心Jar包（无内置依赖） ├─ lib/ # 第三方依赖Jar包目录 ├─ resources/ # 项目配置文件目录 └─ start_cp.bat # 对应启动脚本四、两套生产级启动脚本（直接复用）
4.1 完整Jar包启动脚本（start_jar.bat）
适用场景：Jar包内置全部依赖，仅需要加载外置resources配置文件，使用标准\-jar方式启动。
@echo off chcp 65001 title 门禁项目重启 :: ========== 【可自定义配置区】 ========== :: 自定义java程序根目录 set "JAVA_HOME=C:\Program Files (x86)\Common Files\Oracle\Java\javapath" :: 项目完整Jar包绝对路径 set "JAR_FILE=E:\hdx\project\yudao-server.jar" :: 项目监听端口（用于查杀旧进程） set "PORT=48080" :: ====================================== :: 强制终止端口占用旧进程 for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":%PORT%" 2^>nul') do taskkill /f /pid %%a >nul 2>&1 echo 旧进程已终止，准备后台启动项目... :: 后台无阻塞启动项目，自定义进程名 start /b "" "%JAVA_HOME%\doorJava.exe" -Xms512m -Xmx1024m -Dfile.encoding=UTF-8 -jar "%JAR_FILE%" :: 自动关闭CMD窗口 exit4.2 瘦身包启动脚本（start_cp.bat）
适用场景：项目瘦身部署，依赖包存放于lib目录、配置文件存放于resources目录，禁止使用-jar参数，通过\-cp加载类路径启动，与Linux启动逻辑完全一致。
@echo off chcp 65001 title 门禁项目重启 :: ========== 【可自定义配置区】 ========== :: 自定义java程序根目录 set "JAVA_HOME=C:\Program Files (x86)\Common Files\Oracle\Java\javapath" :: 项目瘦身Jar包绝对路径 set "JAR_FILE=E:\hdx\project\yudao-server.jar" :: 项目监听端口（用于查杀旧进程） set "PORT=48080" :: 项目启动主类（全限定类名） set "MAIN_CLASS=cn.iocoder.yudao.server.YudaoServerApplication" :: ====================================== :: 强制终止端口占用旧进程 for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":%PORT%" 2^>nul') do taskkill /f /pid %%a >nul 2>&1 :: 等待端口彻底释放 timeout /t 2 /nobreak >nul echo 旧进程已终止，准备后台启动项目... :: 加载主Jar+全部依赖+外置配置，后台启动项目 start /b "" "%JAVA_HOME%\doorJava.exe" ^ -Xms512m -Xmx1024m -Dfile.encoding=UTF-8 ^ -cp "%JAR_FILE%;lib/*;resources" %MAIN_CLASS% :: 自动关闭CMD窗口 exit五、脚本使用规范
5.1 基础使用步骤
根据项目部署模式，选择对应启动脚本；
修改脚本中配置区参数，适配本机路径、端口、启动主类；
双击bat文件运行，执行效果：短暂弹出CMD窗口→自动查杀旧进程→后台启动项目→窗口自动关闭；
打开任务管理器-详细信息，可看到自定义名称的Java进程，项目正常后台常驻运行。
5.2 核心参数详解
chcp 65001：设置终端编码为UTF-8，彻底解决配置、日志中文乱码问题；netstat \-ano \+ findstr：精准查询端口对应进程PID，配合taskkill强制结束进程；start /b：核心关键命令，让Java进程脱离CMD终端，无阻塞运行，保证窗口可正常关闭；\-Xms/\-Xmx：JVM堆内存配置，可根据服务器配置按需调整；\-cp：类路径加载参数，Windows用分号;分隔，Linux用冒号:分隔；lib/\*：批量加载lib目录下所有依赖Jar包（仅CMD终端生效，PowerShell不支持通配符）。
六、常见问题排查
6.1 CMD窗口无法自动关闭
问题原因：未使用start /b命令，Java进程前台阻塞CMD终端，窗口会一直挂起。
解决方案：启动命令必须添加start /b \&\#34;\&\#34;，让进程独立于CMD运行，终端可正常退出。
6.2 PowerShell执行弹出打开方式选择框
问题原因：PowerShell对.jar文件存在系统默认关联，无法直接识别Java启动命令。
解决方案：禁止在PowerShell中执行启动命令，直接双击bat脚本运行即可。
6.3 瘦身包启动无日志、进程卡住不运行
检查目录：
lib、resources必须与瘦身Jar包同级目录；检查语法：-jar 和 -cp 参数禁止同时使用，两种启动模式二选一；
检查主类：确保配置的启动主类全限定名与项目实际主类一致。
6.4 端口反复占用、释放失败
解决方案：脚本已内置强制杀进程逻辑，若仍占用，手动打开任务管理器，结束自定义名称的Java进程即可。
七、方案优缺点总结
7.1 优点
零成本无依赖：纯Windows原生批处理，无需安装任何第三方软件；
进程区分清晰：自定义业务进程名，多服务部署运维效率大幅提升；
运维便捷：自动杀端口、后台静默启动、自动关窗，一键启停项目；
跨平台统一：瘦身包
\-cp启动逻辑与Linux完全一致，适配多环境部署。
7.2 缺点
需手动复制并重命名java.exe文件，首次部署需简单配置；
自定义进程仅对当前启动脚本生效，更换启动程序需重新适配。
八、多服务部署扩展方案
单服务器部署多个Java项目时，可针对不同业务单独自定义Java进程名，实现进程精准区分：
门禁业务服务 → 自定义进程名：
doorJava\.exe监控业务服务 → 自定义进程名：
monitorJava\.exe系统后台服务 → 自定义进程名：
adminJava\.exe
每个业务项目对应一套独立启动脚本和自定义启动程序，任务管理器可直观区分所有服务进程，运维排查零混淆。