Flask集成Google OAuth时PostgreSQL数值超出范围错误求助

问题根源 #

PostgreSQL的Integer类型最大值为2147483647，而Google返回的用户ID（sub字段）是远大于该值的超大数字，直接存入Integer类型字段必然触发数值越界错误。你改字符串未解决问题，大概率是修改不彻底或逻辑存在疏漏。

具体修复步骤 #

1. 修正OAuth模型字段定义
   确认你的OAuth模型中，存储第三方平台用户ID的字段（比如provider_user_id）类型正确，不要和关联自身系统用户表的user_id外键混淆：

   from sqlalchemy import Column, Integer, String, ForeignKey
   from sqlalchemy.orm import relationship
   
   class OAuth(db.Model):
       id = Column(Integer, primary_key=True)
       # 关联自身系统用户表的外键，用Integer没问题
       user_id = Column(Integer, ForeignKey('users.id'), nullable=False)
       provider = Column(String(50), nullable=False)  # 标识平台：google/github
       # 存储第三方用户ID，推荐用String（兼容非数字类型的第三方ID）
       provider_user_id = Column(String(255), nullable=False)
       user = relationship('User', back_populates='oauths')
   

   也可以用BigInteger类型，但String更通用，避免后续其他平台的ID格式问题。

2. 调整回调逻辑的赋值逻辑
   处理Google回调时，要把Google返回的sub值赋值给provider_user_id，而不是错误地赋值给关联自身用户表的user_id：

   @app.route('/google/callback')
   def google_callback():
       resp = google.authorized_response()
       if not resp or not resp.get('access_token'):
           return f"Access denied: {request.args.get('error_description')}"
       
       session['google_token'] = (resp['access_token'], '')
       user_info = google.get('userinfo').json()
       google_user_id = user_info['sub']
       email = user_info['email']
   
       # 检查该Google账号是否已关联系统用户
       oauth_record = OAuth.query.filter_by(provider='google', provider_user_id=google_user_id).first()
       if oauth_record:
           user = oauth_record.user
       else:
           # 查找已有邮箱用户，无则创建新用户
           user = User.query.filter_by(email=email).first() or User(email=email, username=email.split('@')[0])
           db.session.add(user)
           db.session.commit()
           # 创建OAuth关联记录
           new_oauth = OAuth(provider='google', provider_user_id=google_user_id, user_id=user.id)
           db.session.add(new_oauth)
           db.session.commit()
       
       login_user(user)
       return redirect('/')
   

3. 执行数据库结构更新
   修改模型后必须同步数据库结构，否则旧的Integer字段仍会存在：

   • 用Flask-Migrate的话：

     flask db migrate -m "update provider_user_id type to String"
     flask db upgrade
     

   • 手动修改数据库（无迁移工具时）：

     ALTER TABLE oauth ALTER COLUMN provider_user_id TYPE VARCHAR(255);
     

4. 排查改字符串未生效的常见原因

   • 未执行数据库迁移/手动修改表结构，数据库字段还是旧的Integer类型；
   • 代码中仍将Google用户ID错误赋值给其他Integer类型字段（比如user_id）；
   • 修改模型后未重启Flask应用，代码未生效；
   • 数据库连接池未刷新，重启数据库或重建连接。

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