1. 离线 Maven 依赖报错：存在包却报红

在内网离线环境中，将外网仓库的 Flowable 包拷贝到本地仓库后，
IDEA 的 Maven Dependencies 面板中 Flowable 依赖报红，但本地仓库明明存在对应包；且 IDEA 偶尔会出现“有时报红、有时正常”的 bug（临时解决方案：清空 <dependencies> 标签内容 → 刷新 Maven → 恢复内容 → 再次刷新 Maven，可临时解决报红）。

1.1 核心原因：依赖传递缺失

Flowable 并非独立依赖包，其内部会依赖其他第三方包（如 flowable-engine 依赖 mybatis、slf4j 等）。若仅拷贝 Flowable 核心包，未同步其依赖的“间接子包”，Maven 会因找不到完整依赖链而报错。

由于 IDEA 不会显示详细缺失信息，需通过 Maven 命令行定位问题：

1. mvn install ；

2. 查看控制台输出，若出现类似以下报错，直接定位缺失的依赖包：

3. 离线maven依赖报错
   我使用的是离线 本地仓库
   将外网仓库中的flowable包拷贝到了内网本地仓库中，maven-dependencies中flowable报红，但是已经存在flowable包了呀（idea不会展示详细缺失的包，且idea中maven-dependencies有bug有时不报红有时一直红，把中的内容清了刷下maven然后恢复内容再刷在就好了）。
   这是由于flowable中依赖的其他包不存在，通过 mvn install，查看控制台报错信息

Failed to execute...not be resolved:xxx:jar:xx

说明缺少 xxx:jar:xx 包，补上包就可以了。
如果缺少的包很多，就直接将包全的那个仓库包copy到本地仓库，相同文件名的系统会提示覆盖还是跳过，选择跳过即可，这样系统会自动新增缺失的包。

需要删除 .repositories和 .lastUpdated 后缀文件，可使用下面的批量脚本
创建文件 clean-maven-files.bat ，双击执行（默认删除当前目录及子目录中所有的，删除了也不会影响现用项目）

@echo off
setlocal enabledelayedexpansion

REM =============================================
REM Maven 仓库清理工具
REM 功能：删除指定路径下所有.repositories和.lastUpdated文件
REM 用法：clean-maven-files.bat [路径]
REM 如果不指定路径，默认使用当前目录
REM =============================================

echo.
echo ==============================
echo  Maven 仓库临时文件清理工具
echo ==============================

REM 检查是否提供了路径参数
if "%~1"=="" (
    set "targetDir=%cd%"
    echo 未指定路径，将清理当前目录：
    echo   %targetDir%
) else (
    set "targetDir=%~f1"
    echo 将清理指定目录：
    echo   %targetDir%
    
    REM 检查目录是否存在
    if not exist "%targetDir%" (
        echo.
        echo 错误：指定的目录不存在！
        echo 请检查路径是否正确。
        echo.
        pause
        exit /b 1
    )
)

echo.
echo 正在搜索需要删除的文件...
echo -----------------------------

REM 初始化计数器
set fileCount=0

REM 搜索并删除 .repositories 文件
for /r "%targetDir%" %%f in (*.repositories) do (
    echo 删除: %%f
    del /f /q "%%f" >nul 2>&1
    set /a fileCount+=1
)

REM 搜索并删除 .lastUpdated 文件
for /r "%targetDir%" %%f in (*.lastUpdated) do (
    echo 删除: %%f
    del /f /q "%%f" >nul 2>&1
    set /a fileCount+=1
)

echo -----------------------------
echo 清理完成！共删除 %fileCount% 个文件。
echo.

REM 如果没有删除任何文件
if %fileCount% equ 0 (
    echo 未找到 .repositories 或 .lastUpdated 文件。
    echo 仓库可能已经是干净状态。
    echo.
)

REM 提示用户操作完成
echo 操作已完成。这些文件通常是Maven下载过程中的临时文件，
echo 删除后Maven会自动重新下载必要的元数据。
echo.

pause

2. Maven 版本与 IDEA 版本适配：避免兼容性问题

注意idea2021 只支持maven3.8.1及以下版本
maven下载地址

3. POM所有依赖报红

可能由于 settings.xml 内容或格式错误，平时都是使用文本编辑器打开根本看不错错误。
方法：在idea中 -> 右键pom.xml -> maven -> Open settings.xml，在这里就能查看、编辑了

总结

1. 离线依赖报红：优先用 mvn install 定位缺失包，批量补充用 “仓库覆盖法”，残留报红用脚本清理临时文件；
2. IDEA 2021 适配：强制搭配 Maven 3.8.1 及以下版本，下载优先选择 Apache 官方归档库；
3. IDEA 临时报红：清空 → 刷新 Maven → 恢复内容 → 再次刷新，可快速缓解