Java编译为什么需要JAR包？从报错到原理，一篇讲透

当编译器说 cannot find symbol 时，它到底在找什么？

引言

你一定遇到过这种情况：Maven项目里少了某个依赖，编译直接报红；但有的JAR包删掉了，编译却风平浪静。更让人困惑的是——明明代码里写了Class.forName("com.mysql.jdbc.Driver")，对应的mysql-connector-java.jar不在也能编译通过。

这背后的核心问题只有两个：

1. 编译器到底验证什么？
2. 什么情况下必须要有JAR包？

本文不讲虚的，直接用三段真实代码 + 编译报错信息，把原理讲清楚。

一、先记住一句话

编译器只检查“直接写出来的类名”，不检查“写在字符串里的类名”。

• 直接写出来的类名：StringUtils.isBlank()、new Gson()、Session session —— 需要JAR
• 写在字符串里的类名：Class.forName("com.mysql.jdbc.Driver") —— 不需要JAR

下面看具体例子。

二、必须要有JAR的3种常见场景

场景1：import 了一个外部类

import org.apache.commons.lang3.StringUtils;   // 需要 commons-lang3.jar

public class Demo {
    public static void main(String[] args) {
        boolean empty = StringUtils.isBlank(" ");
        System.out.println(empty);
    }
}

缺少JAR时编译报错：

Demo.java:1: error: package org.apache.commons.lang3 does not exist
import org.apache.commons.lang3.StringUtils;
                                ^
Demo.java:6: error: cannot find symbol
        boolean empty = StringUtils.isBlank(" ");
                        ^
  symbol:   variable StringUtils
  location: class Demo

为什么报错？
编译器看到StringUtils.isBlank(...)时，必须查清三件事：

• StringUtils是类还是接口？
• isBlank方法有几个参数？参数类型是什么？
• 返回值是boolean吗？

这些信息全在commons-lang3.jar的StringUtils.class里，没有就报错。

场景2：用 new 创建对象

import com.google.gson.Gson;   // 需要 gson.jar

public class Demo {
    public static void main(String[] args) {
        Gson gson = new Gson();   // 编译器需要知道 Gson 的构造器
        String json = gson.toJson(new Object());
        System.out.println(json);
    }
}

缺少JAR时编译报错：

Demo.java:1: error: package com.google.gson does not exist
import com.google.gson.Gson;
                      ^
Demo.java:6: error: cannot find symbol
        Gson gson = new Gson();
        ^
  symbol:   class Gson
  location: class Demo

为什么报错？
new Gson()要求编译器验证：

• Gson类是否存在
• 无参构造器是否存在（如果你写new Gson(String)，编译器还要检查参数类型是否匹配）

这些信息只能在gson.jar里找到。

场景3：方法返回值或参数使用了外部类型

即使没有显式import，只要类型名出现在方法签名中，编译器也要查JAR。

public class MyService {
    // 返回类型是 Hibernate 的 Session —— 需要 hibernate-core.jar
    public Session getSession() {
        return null;
    }
}

缺少JAR时编译报错：

MyService.java:3: error: cannot find symbol
    public Session getSession() {
           ^
  symbol:   class Session
  location: class MyService

为什么报错？
编译器必须知道Session是什么类型，才能验证这个方法返回的值是否合法（即使你现在返回null，类型检查也绕不过去）。

三、不需要JAR的典型场景：JDBC驱动

这是最容易混淆的地方。

import java.sql.Connection;
import java.sql.DriverManager;

public class Demo {
    public static void main(String[] args) throws Exception {
        // 类名写在字符串里 —— 编译器不管
        Class.forName("com.mysql.cj.jdbc.Driver");

        Connection conn = DriverManager.getConnection(
            "jdbc:mysql://localhost:3306/test", "root", "123"
        );
        System.out.println(conn);
    }
}

即使删掉mysql-connector-java.jar，编译依然通过：

（没有任何报错，成功生成 .class 文件）

为什么？
编译器检查的所有类型都来自JDK核心库：

• java.sql.Connection → 在rt.jar里
• java.sql.DriverManager → 也在rt.jar里
• Class.forName(String) → 这是java.lang.Class的方法，同样来自JDK

而"com.mysql.cj.jdbc.Driver"只是一段普通文本，编译器不会去验证它是否对应一个真实类。

⚠️ 注意：编译虽然通过，但运行时执行到Class.forName()那行时，如果JAR不在classpath中，会抛出ClassNotFoundException。

四、为什么会有这种区别？—— 从字节码看本质

直接引用（需要JAR）和字符串引用（不需要JAR）在生成的字节码上完全不同：

直接引用生成的字节码

StringUtils.isBlank(" ");

对应的字节码：

ldc " "
invokestatic  #2   // Method org/apache/commons/lang3/StringUtils.isBlank:(Ljava/lang/String;)Z

#2指向常量池中的方法签名，包含了完整的类名、方法名、参数类型和返回类型。编译器生成这条指令时，必须确认这些信息准确无误。

字符串引用生成的字节码

Class.forName("com.mysql.cj.jdbc.Driver");

对应的字节码：

ldc "com.mysql.cj.jdbc.Driver"
invokestatic  #4   // Method java/lang/Class.forName:(Ljava/lang/String;)Ljava/lang/Class;

这里只是加载了一个字符串常量，然后调用JDK自带的forName方法。编译器完全不需要知道这个字符串代表什么类。

五、一张表总结：何时需要JAR？

六、回到Maven实践：为什么还要声明运行时依赖？

既然有些JAR编译时不需要，为什么pom.xml里还要写？

1. 打包部署：mvn package会把所有compile和runtime范围的依赖打进去，保证运行时能找到。
2. 版本统一管理：Maven的依赖管理帮你锁定版本，避免多人协作时版本不一致。
3. IDE智能提示：IDE基于Maven依赖树提供代码补全，虽然编译不需要，但开发时需要。
4. 传递依赖：你依赖的A包可能依赖了B包，Maven帮你自动引入。

所以，即使某个JAR编译时不参与符号解析，为了运行时不出错，pom.xml里通常还是会声明它（scope可能设为runtime）。

七、终极总结

编译器的职责是“静态检查”，它像一位严格的语法老师，逐字逐句地读你的代码，遇到任何作为类型名出现的标识符，就必须在classpath里找到它的定义。

而写在字符串里的类名（包括配置文件里的），编译器视而不见——那是运行时ClassLoader才管的事。

所以下次再看到编译报错cannot find symbol时，你就知道：编译器在说“你代码里用到的这个类，我没找到它的‘说明书’，没法继续往下编译了”。

如果这篇文章帮你理清了依赖管理的困惑，欢迎留言讨论。关于@Autowired、@Value等注解为什么需要JAR，原理其实完全一样——注解也是类，你写@Autowired就相当于引用了Autowired这个类型，编译器必须找到它。如果你感兴趣，我们可以再单独聊这个话题。