75 lines
2.4 KiB
Plaintext
75 lines
2.4 KiB
Plaintext
|
==========================================
|
|||
|
|
NPQS9100 Java 后端服务说明
|
|||
|
|
==========================================
|
|||
|
|
|
|||
|
|
一、目录结构
|
|||
|
|
----------------------------------------
|
|||
|
|
entrance.jar - Spring Boot 应用程序
|
|||
|
|
application.yml - 应用配置文件（自动生成）
|
|||
|
|
application.yml.template - 配置模板
|
|||
|
|
kill-java-port.bat - 智能清理Java端口占用（紧急用）
|
|||
|
|
.running-port - 运行时端口记录（自动生成，勿删除）
|
|||
|
|
|
|||
|
|
|
|||
|
|
二、自动管理
|
|||
|
|
----------------------------------------
|
|||
|
|
正常情况下，Java 后端服务由主应用自动管理：
|
|||
|
|
- 应用启动时自动启动 Java 服务
|
|||
|
|
- 应用关闭时自动停止 Java 服务
|
|||
|
|
- 无需手动操作
|
|||
|
|
|
|||
|
|
|
|||
|
|
三、端口智能管理
|
|||
|
|
----------------------------------------
|
|||
|
|
- Java 服务默认使用端口：18092
|
|||
|
|
- 如果 18092 被占用，自动尝试：18093, 18094, ...
|
|||
|
|
- 启动成功后会记录实际端口到 .running-port 文件
|
|||
|
|
- kill-java-port.bat 会自动识别正确的端口进行清理
|
|||
|
|
|
|||
|
|
|
|||
|
|
四、手动清理工具
|
|||
|
|
----------------------------------------
|
|||
|
|
如果应用异常退出，Java 进程可能残留，导致：
|
|||
|
|
- 端口被占用，无法再次启动
|
|||
|
|
- 可以运行 kill-java-port.bat 清理残留进程
|
|||
|
|
|
|||
|
|
使用方法：
|
|||
|
|
1. 双击运行：kill-java-port.bat
|
|||
|
|
2. 脚本会自动识别实际使用的端口
|
|||
|
|
3. 清理完成后即可重新启动应用
|
|||
|
|
|
|||
|
|
|
|||
|
|
五、安全说明
|
|||
|
|
----------------------------------------
|
|||
|
|
⚠️ 进程停止安全性：
|
|||
|
|
- 应用自动停止时，只会停止应用自己启动的 Java 进程
|
|||
|
|
- 通过进程引用精确停止，不会影响其他 Java 应用
|
|||
|
|
- kill-java-port.bat 只清理占用特定端口的进程
|
|||
|
|
- 完全不会影响您电脑上的其他 Java 程序
|
|||
|
|
|
|||
|
|
⭐ 端口冲突处理：
|
|||
|
|
- 如果您的电脑上有其他应用占用了 18092 端口
|
|||
|
|
- 本应用会自动切换到其他端口（18093, 18094...）
|
|||
|
|
- kill-java-port.bat 会自动识别实际端口，精确清理
|
|||
|
|
|
|||
|
|
|
|||
|
|
六、常见问题
|
|||
|
|
----------------------------------------
|
|||
|
|
Q: Java 服务无法启动？
|
|||
|
|
A: 运行 kill-java-port.bat 清理残留进程
|
|||
|
|
|
|||
|
|
Q: 端口被占用怎么办？
|
|||
|
|
A: 应用会自动切换端口，无需手动处理
|
|||
|
|
|
|||
|
|
Q: 如何查看 Java 日志？
|
|||
|
|
A: 启动应用后，日志窗口会实时显示 Java 输出
|
|||
|
|
|
|||
|
|
Q: 配置文件在哪里？
|
|||
|
|
A: application.yml 由应用自动生成，请勿手动修改
|
|||
|
|
|
|||
|
|
|
|||
|
|
==========================================
|
|||
|
|
南京灿能电气自动化有限公司
|
|||
|
|
2025
|
|||
|
|
==========================================
|