JAR包为什么在服务器上运行不了?,JAR包启动失败怎么办?

jar文件在服务器上跑不起来,绝大多数情况不是代码写错了,而是运行环境、启动命令、端口权限这三处里至少有一处没对齐。 先别急着重打包,按下面这条排查线走一遍,八成能自己定位到卡点。

先分清是”压根没启动”还是”启动后又退出”

这两种现象的处理路径完全不同,前者通常一秒内就报错返回,屏幕上留一行异常;后者往往先打印几行 Spring 日志,然后进程悄无声息消失,先看现象,再动手。

打jar包到服务器上运行,解决依赖问题
加载中
打jar包到服务器上运行,解决依赖问题

环境层: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,别慌,按清单查。

三步确认清单

  1. 看清单文件里有没有主类:
    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。
  2. 看 jar 里有没有被”瘦身”:
    unzip -l app.jar | head -50
    如果只看到你自己的 class,看不到 BOOT-INF/lib,说明打出来的是普通 jar,不是可执行 jar。
  3. 看启动类路径是否写错:
    手动指定主类时,包名要和目录结构严格对应,一个大小写错位就会报找不到类。

启动命令的正确写法

最简版本:

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 --permanent firewall-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

赞 (0)
上一篇 2026年11月22日 12:46
下一篇 2026年11月22日 12:48

相关推荐

  • 行情源多路冗余接入如何避免单点断流?部署方式有哪些?

    行情源多路冗余接入的部署方式,核心是三条链路并行、故障自动切换、数据交叉校验,从架构上消除单点断流的可能性,行情源冗余的必要性:断流一次,代价多大做交易的人都有过这种经历:行情卡住不动,下单界面转圈,等恢复过来,价格已经跑到另一边去了,衍生品交易、量化策略执行、做市商报价,这些场景对行情的实时性和连续性要求极高……

    2026年9月8日
    400
  • aspnet页签,如何优化页签功能,提升用户体验与开发效率?

    ASP.NET页签(Tab)是Web开发中常见的界面组件,用于在有限空间内组织并切换多个内容面板,提升用户操作效率和页面整洁度,它通过将相关内容分组到不同标签页中,实现单页面内动态加载,避免跳转或刷新,从而优化用户体验和页面性能,在ASP.NET中,页签可通过多种技术实现,包括服务器端控件(如ASP.NET A……

    2026年2月3日
    14100
  • 香港快云科技服务器测评,CN2 GIA实测体验,香港服务器怎么选?

    香港快云科技服务器在 2026 年 CN2 GIA 实测中展现出极低的延迟与极高的稳定性,是解决跨境业务访问卡顿、提升东南亚及中国大陆用户访问体验的高性价比选择,尤其适合对网络质量有严苛要求的金融与电商场景,随着 2026 年跨境数字贸易的爆发式增长,网络基础设施的稳定性已成为企业核心竞争力的关键指标,在众多海……

    2026年5月11日
    7000
  • 如何用LR监控服务器性能指标,有哪些实用方法?

    用LR(LoadRunner)监控服务器性能指标,核心路径有两条:一是通过Controller内置的系统资源监控器直接采集,二是结合SiteScope(LR企业版附带组件)做无侵入式监控,前者操作快、适合现场调试,后者部署轻、适合持续监控,配置LR监控前,先搞清楚它靠什么采集数据LR本身不生产监控数据,它只是……

    程序编程 2026年11月17日
    1300
  • 服务器ip地址忘记了怎么办?如何快速查询服务器IP

    面对服务器IP地址遗忘的紧急情况,最直接、高效的解决方案是登录云服务商控制台查看实例详情,或通过本地网络工具扫描局域网网段,亦或利用服务器厂商提供的远程管理卡(如iDRAC/iLO)进行找回,这三种途径分别适用于云服务器、内网物理服务器以及拥有独立管理芯片的企业级设备,掌握这些核心方法,能在最短时间内恢复对服务……

    2026年4月5日
    31900
  • 浙江大带宽租用包年费用怎么谈更划算,哪家便宜

    浙江大带宽租用包年费用想谈得划算,核心就三件事:先按真实流量曲线定带宽规格,再用年付和打包换折扣,最后把扩容、SLA、退费条款写进合同,只盯着单价砍价,往往省不下钱,还容易在后期扩容时被反咬一口,先弄明白钱花在哪:浙江大带宽包年费用的定价逻辑谈价之前得知道对方报价单里每一项对应什么成本,否则你砍的可能是别人的底……

    程序编程 2026年11月19日
    400
  • 我的世界网易版2b2t服务器怎么进?,进不去怎么办

    对于“我的世界网易版2b2t服务器怎么进”这个问题,核心答案是:由于网易版客户端限制,你无法直接进入原版2b2t.org服务器,但可以通过使用Java版官方启动器或第三方启动器来实现,同时网易版内也有不少模仿2b2t风格的无政府服务器可供选择,为什么网易版客户端无法直接连接2b2t很多玩家在网易版启动器里搜了半……

    2026年8月6日
    1400
  • cad如何转成excel,具体步骤是什么?

    将CAD图纸中的表格、清单或属性数据转移到Excel中,是工程人几乎每天都会遇到的需求,最稳妥的路径是:通过AutoCAD内建的“数据提取”功能或一款经过市场验证的第三方转换插件,结合图纸前处理,导出的结果能满足绝大多数造价统计和材料管理场景,核心是让源图纸的结构标准化,CAD转Excel表格格式错乱怎么办?原……

    2026年7月15日
    1600
  • 剑网三服务器卡顿怎么办,游戏延迟高如何优化?

    剑网三服务器卡顿怎么解决,先分清锅在谁身上剑网三服务器卡顿最核心的解决思路是:先判断延迟高是自家网络问题还是服务器本身波动,再对症下药,盲目换加速器或重装游戏只会浪费时间,很多玩家一遇到服务器卡顿,第一反应就是砸键盘骂策划,然后把加速器换了个遍,甚至重装游戏,结果该卡还是卡,作为在剑网三摸爬滚打多年的老玩家,我……

    程序编程 2026年11月21日
    200
  • CDN加速国外服务器为什么用不了,是什么原因?

    CDN加速国外服务器用不了,绝大多数情况下不是CDN服务本身的问题,而是回源配置、域名解析或防火墙规则这三处没打通,按顺序排查即可解决,排查前先确认:你的CDN真的“没生效”吗很多朋友说“用不了”,其实是把CDN加速和服务器直连搞混了,CDN生效的标志是域名解析指向CDN节点IP,而不是源站IP,如果配置后pi……

    程序编程 2026年11月5日
    1100

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注