Maven引入Dotenv依赖报错：Cannot resolve symbol 'github'

排查及解决步骤： #

• 手动同步IDE与Maven依赖
  终端执行Maven命令后，IDE可能未自动同步依赖状态。操作方式：

  • IntelliJ IDEA：点击右侧Maven面板的刷新按钮（🔄），或使用快捷键Ctrl+Shift+O（Windows/Linux）/Cmd+Shift+O（Mac）导入变更。
  • Eclipse：右键项目 → Maven → Update Project，勾选"Force Update of Snapshots/Releases"后确认更新。

• 检查本地Maven仓库的依赖文件
  打开本地Maven仓库默认路径~/.m2/repository/io/github/cdimascio/java-dotenv/5.2.2，确认是否存在java-dotenv-5.2.2.jar等核心文件。如果缺失，大概率是网络问题导致依赖下载失败：

  1. 换国内Maven镜像加速下载，在~/.m2/settings.xml（或Maven安装目录conf/settings.xml）中添加：

     <mirrors>
         <mirror>
             <id>aliyunmaven</id>
             <mirrorOf>central</mirrorOf>
             <url>https://maven.aliyun.com/repository/public</url>
         </mirror>
     </mirrors>
     

  2. 重新执行mvn clean install -U（-U参数强制更新依赖）。

• 确认pom.xml的依赖范围
  检查依赖是否被错误设置了provided或test这类限制编译期使用的范围，当前配置默认compile是正常的，确保没有多余的<scope>标签：

  <dependency>
      <groupId>io.github.cdimascio</groupId>
      <artifactId>java-dotenv</artifactId>
      <version>5.2.2</version>
  </dependency>
  

• 清理IDE缓存
  IDE缓存损坏可能导致依赖识别异常：

  • IntelliJ IDEA：File → Invalidate Caches... → 勾选"Clear file system cache and local history" → 点击Invalidate and Restart。
  • Eclipse：Window → Preferences → General → Workspace → 点击"Clear"清理构建缓存，再重新构建项目。

• 验证Java版本兼容性
  java-dotenv 5.x版本要求Java 8及以上，在pom.xml中确认项目Java版本符合要求：

  <properties>
      <java.version>1.8</java.version> <!-- 可根据需求改为11、17等更高版本 -->
  </properties>
  

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