通过Maven引入本地Jar包时IntelliJ仅可使用类全限定名访问的问题

• 校验Jar包内目标类的访问权限：确认需要导入的com.companyname.app.Abc类修饰符为public。如果类没有添加public修饰符（默认包访问权限），仅支持同包路径下的类直接访问，跨包场景下要么无法访问要么只能通过全限定名调用，该场景需要调整Jar包对应类的访问修饰符后重新打包发布即可。
• 清理IDEA缓存并重启：IDEA本地缓存损坏是此类导入异常的高频原因，操作路径为：顶部菜单栏选择 File → Invalidate Caches...，勾选Clear file system cache and local history后点击Invalidate and Restart，等待IDEA重启完成后重新编译项目验证。
• 检查依赖作用域配置：确认该Maven依赖未设置scope为test或provided，test作用域的依赖仅对项目test源码目录生效，provided作用域的依赖仅在编译阶段可用，两类配置都可能导致main目录下的代码无法正常导入依赖类。
• 强制同步Maven项目：右键项目根目录下的pom.xml文件，选择 Maven → Reload project 强制重新拉取同步所有依赖配置，对齐IDEA与Maven的项目结构。
• 排查同名类冲突：如果当前编写代码的类所在包下存在同名Abc类，或者已经导入其他包路径下的Abc类，会触发类名冲突，必须通过全限定名区分不同类，该场景可调整类名避免冲突或直接使用全限定名访问。

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