基于Sails.js+MySQL的Google身份验证实现故障求助

看起来你在搭建Sails.js + MySQL的项目时，用Passport结合passport-google-oauth的OAuth2Strategy做Google身份验证，卡在了无法获取Google返回的用户数据这一步。我结合你给出的代码片段，一步步帮你排查和解决：

1. 先补全并检查基础代码完整性 #

你提供的express.js代码片段不完整，首先要确保核心配置和逻辑都到位：

var passport = require('passport'),
    GoogleStrategy = require('passport-google-oauth').OAuth2Strategy;

// 首先配置Google OAuth2策略，这里的参数必须和Google控制台完全匹配
passport.use(new GoogleStrategy({
    clientID: '你的Google客户端ID',
    clientSecret: '你的Google客户端密钥',
    callbackURL: 'http://localhost:1337/auth/google/callback', // 要和Google控制台的重定向URI完全一致
    scope: ['email', 'profile'] // 必须指定scope才能拿到用户邮箱、基本信息
}, verifyHandler));

// 验证回调函数，这里是处理Google返回数据的核心
var verifyHandler = function(token, tokenSecret, profile, done) {
    process.nextTick(function() {
        // 先打印profile，确认是否拿到数据——这一步是调试关键
        console.log('Google返回的用户数据:', profile);
        
        // 补全你未写完的User查询/创建逻辑
        User.findOne({ googleId: profile.id }).exec(function(err, user) {
            if (err) return done(err);
            // 如果用户已存在，直接返回
            if (user) return done(null, user);
            
            // 如果用户不存在，创建新用户并存入MySQL
            User.create({
                googleId: profile.id,
                email: profile.emails[0].value,
                displayName: profile.displayName,
                avatar: profile.photos[0].value
            }).exec(function(err, newUser) {
                if (err) return done(err);
                return done(null, newUser);
            });
        });
    });
};

// 别忘了在Sails的http中间件里挂载Passport
// 在config/http.js中添加：
// middleware: {
//   passportInit: require('passport').initialize(),
//   passportSession: require('passport').session(),
//   order: [
//     'passportInit',
//     'passportSession',
//     // 其他原有中间件...
//   ]
// }

2. 排查无法获取数据的核心原因 #

原因1：Google控制台配置错误 #

• 确保你在Google Cloud控制台中，OAuth2客户端的授权重定向URI和代码里的callbackURL完全一致（包括HTTP/HTTPS、域名、端口，不能有任何拼写错误）
• 确认已经启用了People API（Google现在已经废弃了Google+ API，必须用People API来获取用户基本信息）

原因2：缺失必要的Scope参数 #

如果没指定scope: ['email', 'profile']，Google只会返回最基础的用户ID，不会返回邮箱、昵称这些关键数据，这是很多人踩坑的点。

原因3：Sails会话配置问题 #

Passport依赖会话保存用户状态，要确保：

• config/session.js中会话已启用（默认的memory适配器在开发环境可用，生产环境建议用Redis等持久化适配器）
• passportSession中间件必须在passportInit之后加载，顺序不能错

原因4：路由配置未到位 #

在config/routes.js中添加授权和回调路由：

'GET /auth/google': 'AuthController.google',
'GET /auth/google/callback': 'AuthController.googleCallback'

然后在api/controllers/AuthController.js实现对应方法：

module.exports = {
    google: function(req, res) {
        passport.authenticate('google')(req, res);
    },
    googleCallback: function(req, res) {
        passport.authenticate('google', {
            successRedirect: '/dashboard',
            failureRedirect: '/login'
        })(req, res);
    }
};

3. 快速调试技巧 #

• 在verifyHandler第一行加console.log('进入Google验证回调')，确认回调是否被触发；如果没触发，优先检查路由和Google控制台的重定向URI
• 如果触发了但profile为空，检查Scope配置和People API是否启用

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