VS Code无构建工具Java项目导入MongoDB库失败求助

场景描述 #

作为Java新手，开发学生管理系统时选择了VS Code的「无构建工具」Java项目，已成功连接MongoDB，但在主代码中导入MongoDB相关包时编译报错。相同代码在Eclipse中可正常运行，示例代码及报错信息如下：

示例代码 #

import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import org.bson.Document;
import static com.mongodb.client.model.Filters.eq;

public class MongoDBTest {
    public static void main(String[] args) {
    }
}

终端报错信息 #

PS E:\VS Workspace> cd "e:\VS Workspace\Java Project\OneDIU\src" ; if ($?) { javac MongoDBTest.java } ; if ($?) { java MongoDBTest }
MongoDBTest.java:1: error: package com.mongodb.client does not exist
import com.mongodb.client.MongoClients;
^
MongoDBTest.java:2: error: package com.mongodb.client does not exist
import com.mongodb.client.MongoClient;
^
MongoDBTest.java:3: error: package com.mongodb.client does not exist
import com.mongodb.client.MongoCollection;
^
MongoDBTest.java:4: error: package com.mongodb.client does not exist
import com.mongodb.client.MongoDatabase;
^
MongoDBTest.java:5: error: package org.bson does not exist
import org.bson.Document;
^
MongoDBTest.java:6: error: package com.mongodb.client.model does not exist
import static com.mongodb.client.model.Filters.eq;
^
MongoDBTest.java:6: error: static import only from classes and interfaces
import static com.mongodb.client.model.Filters.eq;
^
7 errors
PS E:\VS Workspace\Java Project\OneDIU\src>

错误原因 #

VS Code终端直接使用javac编译时，未将MongoDB的依赖jar包加入编译类路径（classpath），导致编译器无法找到这些第三方库的包。而Eclipse中你应该已经通过「添加外部JAR」的方式将MongoDB的jar包加入了项目构建路径，因此能正常编译。

解决方法 #

方法一：手动指定类路径编译运行 #

1. 下载MongoDB Java驱动的核心jar包：包括mongodb-driver-core、mongodb-driver-sync、bson，可以从MongoDB官方或Maven仓库获取对应版本。
2. 在项目根目录下创建lib文件夹，将所有下载的jar包放入其中。
3. 使用带-cp参数的命令编译和运行：
   • 编译命令（Windows）：

     cd "e:\VS Workspace\Java Project\OneDIU"
     javac -cp "src;lib/*" src/MongoDBTest.java
     

   • 运行命令（Windows）：

     java -cp "src;lib/*" MongoDBTest
     

   （如果是Linux/macOS系统，将路径分隔符改为冒号:即可）

方法二：改用Maven管理项目（更推荐） #

无构建工具的项目手动管理依赖效率低，推荐转为Maven项目简化依赖管理：

1. 在VS Code中按下Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac），输入「Java: Create Maven Project」，按向导创建Maven项目。
2. 将原项目src目录下的代码复制到新Maven项目的src/main/java目录中。
3. 打开项目根目录的pom.xml，添加MongoDB依赖：

   <dependencies>
       <dependency>
           <groupId>org.mongodb</groupId>
           <artifactId>mongodb-driver-sync</artifactId>
           <version>4.11.1</version> <!-- 可替换为最新稳定版 -->
       </dependency>
   </dependencies>
   

4. 保存pom.xml后，VS Code会自动下载依赖，之后即可正常编译运行代码。

内容的提问来源于stack exchange，提问作者Tasinur Rahman