Node.js中Passport.js注册表单出现Cannot read property 'body'错误排查

这个Cannot read property 'body' of undefined错误本质上是说你在尝试访问req.body时，req.body根本不存在——说白了就是Express没帮你解析POST请求里的表单数据，导致后续的Passport或者你的控制器拿不到提交的手机号、密码这些字段。下面一步步拆解问题和解决办法：

1. 最核心的原因：没配置请求体解析中间件 #

Express默认不会自动解析POST请求的请求体，你必须手动添加express.json()和express.urlencoded()中间件，而且一定要把这些中间件放在Passport配置、路由注册的前面，不然请求到路由的时候还没被解析，req.body自然就是undefined。

举个正确的配置顺序例子：

const express = require('express');
const app = express();

// 先搞定请求体解析！这步是重中之重
app.use(express.json()); // 处理JSON格式的请求（比如AJAX提交）
app.use(express.urlencoded({ extended: true })); // 处理传统表单格式的请求

// 再配置Passport
const passport = require('./your-passport-config-path');
app.use(passport.initialize());
app.use(passport.session());

// 最后注册路由
app.use('/api/auth', require('./your-auth-routes-path'));

如果你的中间件顺序搞反了（比如先注册路由再加解析中间件），那路由处理请求的时候，请求体还没被解析，肯定会触发这个错误。

2. 检查Passport-local策略的字段配置 #

如果你已经加了解析中间件，那还要确认Passport-local策略有没有正确指定表单字段名。默认情况下，Passport-local会找req.body.username和req.body.password，但你用的是手机号作为标识，所以得手动设置usernameField为你的表单字段名（比如phone）：

const LocalStrategy = require('passport-local').Strategy;

passport.use('local-signup', new LocalStrategy({
    usernameField: 'phone', // 这里要和你表单里的手机号字段名完全一致
    passwordField: 'password',
    passReqToCallback: true // 如果需要在回调里直接访问req，记得开这个
}, async (req, phone, password, done) => {
    try {
        // 这里可以直接用参数里的phone，也可以用req.body.phone（前提是req.body存在）
        const existingUser = await User.findOne({ phone: phone });
        if (existingUser) {
            return done(null, false, { message: '该手机号已被注册' });
        }
        // 剩下的注册逻辑...
    } catch (err) {
        return done(err);
    }
}));

要是你没指定usernameField，Passport会去req.body.username里找值，而你的表单字段是phone，那也会间接导致后续逻辑出错，但首先得确保req.body本身是存在的。

3. 确认请求本身的格式没问题 #

• 如果你是用HTML表单提交，确保表单的method是POST，而且不要乱改enctype（默认的application/x-www-form-urlencoded就可以）。
• 如果你是用AJAX/axios提交，记得设置正确的Content-Type：如果是JSON格式，要设置为application/json；如果是表单格式，设置为application/x-www-form-urlencoded。

快速排查步骤总结 #

1. 先检查入口文件（比如app.js）里，express.json()和express.urlencoded()是不是在路由、Passport配置之前加载的。
2. 确认Passport-local策略的usernameField和你表单里的手机号字段名匹配。
3. 用Postman或者浏览器开发者工具测试请求，看看提交的参数是不是真的发送到了服务器。

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