树莓派部署ExpressJS网站遇require(...) is not a function错误排查
树莓派Express启动报错排查方案
该报错发生在Express包内部加载阶段,尚未执行到你的项目业务代码,因此不需要优先调整业务逻辑,核心问题是树莓派上的Node.js与Express版本不兼容
第一步:对比两端Node.js版本
- 在可正常运行的笔记本上执行以下命令,记录输出的版本号:
node -v && npm -v - 在树莓派上执行同样命令,对比版本差异
- 树莓派通过apt源默认安装的Node.js往往版本偏老(常见为Node 12.x甚至更早),而新版本Express(4.19+、Express 5.x)对Node版本要求最低为10.16+,如果树莓派的Node版本过低,就会出现内部模块导出类型不匹配、
require() is not a function的报错。
第二步:清理混乱的依赖、安装匹配版本的Express
你当前树莓派上的Express安装在/home/pi/node_modules路径,属于非项目目录的全局乱装依赖,非常容易出现版本冲突:
- 先删除根目录下乱装的node_modules:
rm -rf /home/pi/node_modules - 进入项目实际存放路径(也就是
/home/pi/RSite/,你的HTML文件所在的目录) - 检查目录下是否存在
package.json,没有的话先初始化项目配置:npm init -y - 回到笔记本上,查询本地正常运行的Express版本:在本地项目目录执行
npm list express,记录具体版本号(比如4.18.2) - 回到树莓派的项目目录,安装和本地完全一致的Express版本,不要装最新版:
npm install express@你查到的具体版本号 - 装完先验证依赖是否正常加载,执行:
node -e "const express = require('express'); console.log('Express加载正常')"
如果输出对应提示,说明依赖层面的问题已经解决。
第三步:修复代码中存在的废弃逻辑(避免后续运行报错)
你代码里使用的domain模块是Node.js早已标记废弃的特性,新版本Node中即将被移除,且当前写法存在错误(domain.active = reqd属于无效赋值,Domain模块无此属性),后续就算Express正常启动,也会出现内存泄漏或运行异常:
可以将原来的Domain中间件替换为通用错误捕获逻辑,删除这部分代码即可:
原中间件替换为:app.use((err, req, res, next) => { res.status(err.statusCode || 500).send('服务器内部错误'); });另外你当前
app.listen的回调写的是字符串对象,不是可执行的回调函数,没有实际输出效果,不影响启动但可以优化为:app.listen(port, "0.0.0.0", () => console.log(`Listening on port ${port}`));
避坑提醒
- 不要把笔记本上的
node_modules文件夹直接拷贝到树莓派上,不同硬件架构的原生依赖编译结果不同,一定会报错 - 树莓派上的Node版本尽量和本地运行的版本对齐,不要强行用老Node跑新版本Express,也不要用新Node跑太老的Express
- 所有依赖一定要安装在项目自身的目录下,不要全局安装在用户根目录,避免跨项目版本冲突
内容的提问来源于stack exchange,提问作者AttributeError
相关产品推荐
相关产品推荐

