在VS Code+Maven环境下无法为JavaFX项目添加log4j2依赖

环境配置 #

• Visual Studio Code 版本1.73.1（已安装Java相关扩展包）
• Apache Maven 3.8.6（版本哈希：84538c9988a25aec085021c365c560670ad80f63）
• Maven主目录：C:\Program Files\apache-maven-3.8.6
• 系统环境信息：

Java version: 19.0.1, 
vendor: Oracle Corporation 
runtime: C:\Program Files\Java\jdk-19 
Default locale: en_US 
platform encoding: UTF-8 
OS name: "windows 10"
  version: "10.0" 
  arch: "amd64" 
  family: "windows

问题描述 #

给JavaFX项目添加Apache Log4j2库时，编译报错：The package org is not accessible。已在pom.xml中添加Log4j2依赖，在App.java中编写了日志相关代码，但错误依然存在。移除Log4j2依赖后项目可正常运行，说明基础依赖配置无问题。其他Maven jar包均可正常导入，仅Log4j2出现此问题。

相关代码 #

pom.xml 文件内容 #

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>javafxdemo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
    </properties>
    <dependencies>

        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>2.19.0</version>
            <type>pom</type>
        </dependency>

        <dependency>
            <groupId>org.controlsfx</groupId>
            <artifactId>controlsfx</artifactId>
            <version>11.1.2</version>
        </dependency>

        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-controls</artifactId>
            <version>13</version>
        </dependency>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-fxml</artifactId>
            <version>13</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.0</version>
                <configuration>
                    <release>11</release>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.openjfx</groupId>
                <artifactId>javafx-maven-plugin</artifactId>
                <version>0.0.6</version>
                <executions>
                    <execution>
                        <!-- Default configuration for running -->
                        <!-- Usage: mvn clean javafx:run -->
                        <id>default-cli</id>
                        <configuration>
                            <mainClass>com.example.App</mainClass>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

App.java 文件内容 #

package com.example;

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;

import java.io.IOException;

import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.LogManager;

/**
 * JavaFX App
 */
public class App extends Application {

    private static Scene scene;
    final static Logger logger = LogManager.getLogger(App.class);

    @Override
    public void start(Stage stage) throws IOException {
        scene = new Scene(loadFXML("primary"), 640, 480);
        stage.setScene(scene);
        stage.show();
    }

    static void setRoot(String fxml) throws IOException {
        scene.setRoot(loadFXML(fxml));
    }

    private static Parent loadFXML(String fxml) throws IOException {
        FXMLLoader fxmlLoader = new FXMLLoader(App.class.getResource(fxml + ".fxml"));
        return fxmlLoader.load();
    }

    public static void main(String[] args) {
        launch();
    }

}

问题复现步骤 #

1. 安装VS Code并配置Java相关扩展
2. 安装JDK 19并配置JAVA_HOME及环境变量
3. 打开VS Code命令面板（Ctrl+Shift+P），选择「Java: Create Java Project...」
4. 选择Maven提供的JavaFX archetype创建项目，设置groupId为com.example，artifactId为demo
5. 验证项目可正常构建运行
6. 通过「JAVA PROJECTS」面板的「Maven Dependencies」添加Log4j2依赖，选择org.apache.logging.log4j:log4j:2.19.0
7. 在App.java中导入Log4j2相关包并实例化Logger
8. 运行项目，触发The package org is not accessible错误

解决方案 #

1. 修正Maven依赖配置 #

当前pom.xml中添加的log4j依赖是POM类型的父依赖，并未引入实际的Log4j2核心库。需要替换为具体的API和核心依赖：

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-api</artifactId>
    <version>2.19.0</version>
</dependency>
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.19.0</version>
</dependency>

或者使用Log4j2的BOM依赖统一管理版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-bom</artifactId>
            <version>2.19.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

2. 处理Java模块化访问问题（若项目为模块化） #

如果你的JavaFX项目是模块化项目（存在module-info.java），需要在该文件中声明对Log4j2模块的依赖：

module com.example.javafxdemo {
    requires javafx.controls;
    requires javafx.fxml;
    requires org.apache.logging.log4j;
    requires org.apache.logging.log4j.core;

    opens com.example to javafx.fxml;
    exports com.example;
}

3. 清理并重新构建项目 #

执行Maven命令清理缓存并重新构建：

mvn clean install

在VS Code中也可以通过右键点击项目选择「Maven: Clean」和「Maven: Install」完成操作。

内容的提问来源于stack exchange，提问作者Wayne Richardson