青龙面板脚本运行报错如何排查？

Question

青龙面板脚本运行时报错“找不到模块”或“Module not found”，通常是因为依赖未正确安装。排查时首先检查脚本所需的依赖包是否已在青龙面板的依赖管理中安装，尤其是nodejs类脚本常需`request`、`crypto-js`等。进入面板【依赖管理】，确认对应环境（如Node16/Node18）下已安装所需模块。若手动安装后仍报错，可尝试删除依赖并重新安装，或通过日志查看具体缺失模块名称。此外，注意脚本运行环境与依赖版本兼容性，避免因Node版本不匹配导致加载失败。

Answer 1

一、问题现象：青龙面板脚本运行报错“Module not found”

在使用青龙面板（QingLong Panel）执行Node.js类自动化脚本时，开发者常遇到如下错误信息：

Error: Cannot find module 'request'
    at Function.Module._resolveFilename (internal/modules/cjs/loader.js:...)
    at Function.Module._load (internal/modules/cjs/loader.js:...)

此类报错表明Node.js运行时无法定位指定模块，通常归因于依赖未正确安装或环境配置不当。

1.1 常见缺失模块示例

• request：用于HTTP请求，虽已废弃但仍广泛存在于旧脚本中
• crypto-js：处理加密逻辑，如AES、MD5等
• axios：现代HTTP客户端替代方案
• dotenv：加载环境变量配置
• tslib：TypeScript编译辅助库
• moment 或 dayjs：时间处理工具
• lodash：实用函数集合
• cheerio：服务器端jQuery实现，用于HTML解析
• form-data：构造multipart/form-data请求体
• ws：WebSocket通信支持

二、排查路径与深度分析流程

遵循从表层到深层的诊断逻辑，构建系统性排查框架：

2.1 初级排查：确认依赖是否已安装

1. 登录青龙面板Web界面
2. 进入【依赖管理】模块
3. 选择对应Node版本环境（如Node16、Node18）
4. 搜索脚本中引用的模块名（如crypto-js）
5. 若未找到，点击“安装”按钮添加依赖
6. 保存后重新运行脚本观察是否解决

2.2 中级排查：验证安装完整性与日志溯源

步骤	操作内容	预期输出
1	查看任务运行日志	定位具体缺失模块名称
2	检查容器内node_modules目录	确认文件是否存在
3	执行npm list <module>	验证依赖树结构
4	重启青龙服务	触发依赖重载机制

2.3 高级排查：环境隔离与版本兼容性分析

青龙面板支持多Node版本共存，但不同脚本可能依赖特定运行时特性。例如：

• 某些模块在Node.js 16中可用，但在Node.js 18+因ESM/CJS互操作变化而失败
• require()调用动态拼接字符串会导致静态分析失效
• 私有模块或Git仓库依赖未配置认证凭据

三、解决方案体系化实施

3.1 标准修复流程

# 进入青龙容器
docker exec -it qinglong bash

# 手动安装缺失模块（以crypto-js为例）
npm install crypto-js --save

# 清除缓存并重建
npm cache clean --force
rm -rf node_modules
npm install

3.2 自动化检测脚本建议

可编写预检脚本扫描所有脚本中的require()语句，提取依赖清单：

const fs = require('fs');
const path = require('path');

function extractRequires(dir) {
    const files = fs.readdirSync(dir);
    const modules = new Set();
    files.forEach(file => {
        const content = fs.readFileSync(path.join(dir, file), 'utf8');
        const matches = content.match(/require\(['"`](.*?)['"`]\)/g);
        if (matches) {
            matches.forEach(m => {
                const mod = m.match(/['"`](.*?)['"`]/)[1];
                if (!mod.startsWith('.')) modules.add(mod);
            });
        }
    });
    return Array.from(modules);
}

3.3 Mermaid 流程图：完整诊断路径

graph TD
    A[脚本报错 Module not found] --> B{检查依赖管理}
    B -- 已安装 --> C[查看运行日志]
    B -- 未安装 --> D[手动安装依赖]
    D --> E[重新运行脚本]
    C --> F[确定缺失模块名]
    F --> G[进入容器调试]
    G --> H[执行npm list / ls]
    H --> I{是否存在?}
    I -- 是 --> J[检查Node版本兼容性]
    I -- 否 --> K[重新install + cache clean]
    J --> L[升级/降级Node环境]
    K --> E
    L --> E
    E --> M[成功运行?]
    M -- 是 --> N[问题解决]
    M -- 否 --> O[检查模块加载方式是否合法]