Express 4.17.1运行报错TypeError: express.json() is not a function如何解决

核心原因 #

你遇到的express.json is not a function报错，本质是Node运行时实际加载的Express版本低于4.16.0——只有4.16.0及以上版本才内置了express.json()和express.urlencoded()这两个解析中间件。哪怕你项目本地node_modules里的Express包信息显示是4.17.1，也大概率是模块加载优先级或者包文件损坏导致加载了旧版本。
常见的触发场景有两个：

• 你之前全局安装过低于4.16.0版本的Express，Node加载模块时优先匹配了全局的旧版本
• 项目安装依赖过程中出现异常，导致node_modules里的Express文件不完整

解决方案 #

按优先级依次尝试：

1. 先修复损坏的本地依赖
   删除项目目录下的node_modules文件夹和package-lock.json文件，重新安装指定版本的Express：

rm -rf node_modules package-lock.json
npm install express@4.17.1

安装完成后重新运行代码，90%以上的同类问题都会在这一步解决。
2. 排查全局版本冲突
执行以下命令查看全局安装的Express版本：

npm list -g express

如果返回的版本号低于4.16.0，卸载全局的旧版本即可：

npm uninstall -g express

你也可以在代码第一行引入Express后加一行打印，确认实际加载的版本：

const express = require('express');
console.log('当前加载的Express版本：', express.version); // 正常应该打印4.17.1

3. 临时兼容方案
   如果暂时不想排查版本问题，可以直接用body-parser中间件过渡，VSCode提示的弃用只是推荐用内置方法，实际在Express4.x版本中body-parser完全可以正常运行：
   首先安装依赖：

npm install body-parser

替换原有的中间件引入代码即可：

const bodyParser = require('body-parser');
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));

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