You need to enable JavaScript to run this app. 树莓派部署ExpressJS网站遇require(...) is not a function错误排查
优惠活动
大模型
产品
解决方案
定价
更多

树莓派部署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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 15:45:08