jar文件在服务器上跑不起来,绝大多数情况不是代码写错了,而是运行环境、启动命令、端口权限这三处里至少有一处没对齐。 先别急着重打包,按下面这条排查线走一遍,八成能自己定位到卡点。
先分清是”压根没启动”还是”启动后又退出”
这两种现象的处理路径完全不同,前者通常一秒内就报错返回,屏幕上留一行异常;后者往往先打印几行 Spring 日志,然后进程悄无声息消失,先看现象,再动手。
环境层:JDK 版本和架构最容易翻车
服务器上的 Java 和你本机的 Java,很可能不是同一个东西。
- 执行
java -version,确认版本号,用高版本 JDK 编译的 class 文件,在低版本 JRE 上会直接抛UnsupportedClassVersionError,报错信息里会写明 class file version 号。 - 执行
which java,确认调用的是你预期的那套 JDK,而不是系统自带的精简版 JRE。 - 执行
uname -m,确认 CPU 架构,本机是 ARM 芯片、服务器是 x86,或者反过来,jar 里的本地库(native library)加载就会失败,典型报错是no jniopts in java.library.path。 - 检查
echo $JAVA_HOME,很多启动脚本依赖这个变量,为空时脚本会静默走到兜底逻辑,用错 Java 版本。
业内专家指出,JDK 大版本不匹配是线上启动失败里最常见的一类,且报错信息往往指向业务代码,容易误导排查方向。
命令层:启动方式本身就写错了
Spring Boot 打出来的 fat jar 有固定结构,依赖全压在 BOOT-INF/lib 下,启动器在 org.springframework.boot.loader 包里,这决定了它只能用 java -jar 启动。
下面这几种写法都会失败:
java -cp app.jar com.xxx.Main:类路径里找不到BOOT-INF/lib下的依赖,直接NoClassDefFoundError。- 手动解压后再运行:Spring Boot 的 jar 不是普通 zip 结构,解压后目录关系被打乱,主类加载器找不到资源。
- 用
sh app.jar或./app.jar直接执行:少了 shebang 或者没有执行权限,shell 会把它当成脚本解析,报一堆语法错误。
jar包在服务器上运行报错找不到主类怎么办
这个报错原文通常是 no main manifest attribute, in app.jar,或者 Could not find or load main class,别慌,按清单查。
三步确认清单
- 看清单文件里有没有主类:
unzip -p app.jar META-INF/MANIFEST.MF
正常应该能看到Main-Class: org.springframework.boot.loader.JarLauncher和Start-Class: 你的启动类,两项缺失,说明打包插件没配对,回到pom.xml检查spring-boot-maven-plugin是否在<build><plugins>里,且执行的是mvn package而不是只跑了compile。 - 看 jar 里有没有被”瘦身”:
unzip -l app.jar | head -50
如果只看到你自己的 class,看不到BOOT-INF/lib,说明打出来的是普通 jar,不是可执行 jar。 - 看启动类路径是否写错:
手动指定主类时,包名要和目录结构严格对应,一个大小写错位就会报找不到类。
启动命令的正确写法
最简版本:
java -jar /opt/app/app.jar
带参数的生产版本:
nohup java -Xms512m -Xmx1024m -Dspring.profiles.active=prod \ -jar /opt/app/app.jar --server.port=8080 > /opt/app/app.log 2>&1 &
几个细节值得留意:nohup 后面必须接 &,否则退出 SSH 会话进程就没了;日志重定向的 2>&1 顺序不能反;路径一律写绝对路径,避免工作目录不同导致读不到配置文件。
云服务器部署springboot jar包详细步骤
从零到跑起来,走一遍完整路径。
从上传到后台常驻
- 上传:
scp app.jar root@服务器IP:/opt/app/,或者用rz、SFTP 工具。 - 建目录并授权:
mkdir -p /opt/app && chown -R appuser:appuser /opt/app,生产环境不建议用 root 跑业务进程。 - 试运行:先前台跑一次,
java -jar app.jar,看日志有没有正常打印启动完成的横幅,这一步能暴露九成的配置问题。 - 转后台:确认无误后加
nohup ... &,再用ps -ef | grep java确认进程在。 - 看日志:
tail -f /opt/app/app.log,重点找Started XxxApplication in xxx seconds这一行。
用 systemd 托管更稳
nohup 的问题是服务器重启后不会自动拉起,写一个服务单元文件更省心:
[Unit] Description=myapp After=network.target [Service] User=appuser WorkingDirectory=/opt/app ExecStart=/usr/bin/java -Xms512m -Xmx1024m -jar /opt/app/app.jar SuccessExitStatus=143 Restart=on-failure [Install] WantedBy=multi-user.target
放到 /etc/systemd/system/myapp.service,systemctl daemon-reload、systemctl enable --now myapp。SuccessExitStatus=143 这一行是给 kill 信号留的余地,不加的话正常停止会被判成失败并触发重启。
本地能跑服务器跑不了:内存和JVM参数的差异
同一个 jar,本机流畅,服务器上跑几分钟就没了,八成是内存。
容器环境里的 cgroup 坑
Java 8 及更早版本读不到容器的内存限制,它按宿主机的物理内存去算堆大小,你以为容器限了 1G,JVM 却按 16G 去申请,触发 OOM Killer 直接把进程干掉,日志里连异常都没有。
判断依据:dmesg -T | grep -i "killed process",能看到内核杀进程的记录,解决办法是显式指定 -Xmx,或者升级到 Java 10 以上,JVM 默认开启容器感知。
本地与服务器的典型差异对比
| 维度 | 本地开发机 | 服务器常见情况 | 引发的现象 |
|---|---|---|---|
| JDK 版本 | 较新,完整 JDK | 可能是老版本或精简 JRE | 类版本不兼容、缺工具类 |
| 可用内存 | 宽松 | 受容器或物理内存限制 | 进程被杀、堆溢出 |
| 端口占用 | 很少冲突 | 多个服务挤在同类端口 | 启动即报地址已被占用 |
| 网络出口 | 直连 | 受安全组和防火墙限制 | 能启动但外部访问不通 |
| 文件权限 | 当前用户可读写 | 运行用户无写权限 | 上传、缓存、日志目录报错 |
行业共识认为,把本地环境当作”能跑就行”的验证标准,是线上问题频发的主要来源之一,本地多留一份与服务器一致的 JDK 版本和内存参数,能省掉大量返工。
简米云服务器运行jar包端口占用和防火墙排查
应用日志显示启动成功,浏览器却打不开,问题基本在端口这一层。
先确认端口被谁占了
ss -lntp | grep 8080或netstat -tunlp | grep 8080,看有没有别的进程占着。- 占用了就换端口:启动参数加
--server.port=8081,或者改application.yml。 - 想直接杀掉占用进程:
lsof -i:8080拿到 PID,再kill -15 PID,优先用-15而不是-9,后者不给应用收尾的机会。 - 低于 1024 的端口属于特权端口,非 root 用户绑定会报权限不足,没必要为此上 root,用 Nginx 反代到高位端口更规范。
再看安全组和系统防火墙
这是云服务器上最高频的”启动成功但访问不了”原因,两层防火墙要分别放行:
- 云平台侧:控制台的安全组入方向规则,放行对应 TCP 端口,授权对象按需收窄。
- 系统侧:CentOS 系用
firewall-cmd --add-port=8080/tcp --permanentfirewall-cmd --reload;Ubuntu 系用ufw allow 8080。 - 还有一层容易被忽略:SELinux 处于 enforcing 状态时可能拦截非标准端口的监听,用
getenforce查看,临时设为 permissive 验证是否是这个原因。
服务器运行jar包需要什么配置
没有统一答案,但可以给一条可落地的参考线。
- 内存:多数中小型业务,2 核 4G 的实例能跑起来,堆内存给 1G 到 1.5G,留足余量给堆外、线程栈和系统进程,堆不是越大越好,超过物理内存会引发频繁换页,性能反而断崖式下跌。
- 磁盘:至少留出 jar 体积数倍的空间放日志,日志文件务必配滚动策略,否则几个月就能撑爆磁盘,写满后应用直接异常退出。
- JDK:优先用 LTS 版本,团队统一版本号,别让开发机和服务器各跑各的。
- 监控:给 JVM 挂上基础监控,能提前看到堆使用率和 GC 频率的变化,比出事后再翻日志高效得多。
关于jar文件在服务器上运行不了的常见问题
jar包启动后日志没有异常但进程消失了,怎么回事?
优先怀疑三件事:一是被 OOM Killer 杀了,查 dmesg;二是启动脚本里 & 没加对,SSH 会话一断进程就跟着退出;三是应用自身调用了 System.exit,看日志末尾有没有对应提示,这三类的排查顺序就按上面来,从内核记录看起最快。
服务器上运行jar包必须用root权限吗?
不需要,也不建议,用普通用户运行,通过 chown 把应用目录、日志目录、上传目录的属主改成该用户即可,只有绑定 1024 以下端口这类场景才涉及特权,而这类需求用 Nginx 反向代理更好解决,以 root 跑业务进程,一旦应用被攻破,攻击者直接拿到系统最高权限。
为什么本地 java -jar 正常,服务器上却提示找不到配置文件?
工作目录不同导致的相对路径失效。java -jar 的 -jar 参数本身不影响配置加载,但 Spring Boot 默认从当前工作目录和 jar 同级目录找 application.yml。nohup 启动时如果没切到应用目录,相对路径就会落空,最稳的做法是显式加 --spring.config.location=/opt/app/config/,把配置路径写死。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/809134.html


