部署含SQLAlchemy与APScheduler的Flask应用至GCP App Engine超时排查

问题背景 #

首次尝试将集成SQLAlchemy与APScheduler的Flask应用部署至Google Cloud App Engine时，出现部署超时失败。已确认Google Cloud Console配置无误，怀疑问题出在Google SQL数据库连接、App Factory实现或APScheduler配置上，需解决部署超时和数据库连接问题。

报错信息 #

Finished Step #3 - "post-buildpack"
PUSH
DONE #

Updating service [default] (this may take several minutes)...failed.
ERROR: (gcloud.app.deploy) Operation [apps/recipe-scraper-inside-my-site/operations/e1dca938-fd40-4113-a849-65cd0324c912] timed out. This operation may still be underway.

应用目录结构 #

• Website
  • __init__.py
  • templates
  • .env
  • 其他项目Python文件
• main.py
• app.yaml
• requirements.txt

配置文件与代码 #

app.yaml配置 #

runtime: python
env: flex
entrypoint: gunicorn -b :$PORT main:app

runtime_config:
  operating_system: ubuntu22

manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

# 环境变量配置
env_variables:
  SQLALCHEMY_DATABASE_URI: 'mysql+mysqldb://<user>:<password>@/<database name>?unix_socket=/cloudsql/<connection ID>'

 app_config_secret_key: '<secret key>'

main.py代码 #

from website import create_app
    
app = create_app()
    
if __name__ == '__main__':
    app.run(debug=True)

init.py代码 #

from flask_sqlalchemy import SQLAlchemy
from os import path
from flask_login import LoginManager
from flask import Flask
from flask_apscheduler import APScheduler
from .tasks import get_gratitude_opted_in_users_and_send_to_all
from os import getenv
from dotenv import load_dotenv

# 创建SQLAlchemy实例
db = SQLAlchemy()
# 数据库名称（本地用）
DB_NAME = "database.db"
 
# 创建数据库函数（本地逻辑）
def create_database(app):
    # 如果数据库文件不存在
    if not path.exists('website/' + DB_NAME):
        # 创建所有表
        db.create_all(app=app)
        print('Created Database!')

# 创建Flask应用函数
def create_app():
    app = Flask(__name__)

    load_dotenv()
    # 设置秘钥
    app.config['SECRET_KEY'] = getenv('app_config_secret_key')
    # 设置数据库连接URI
    app.config['SQLALCHEMY_DATABASE_URI'] = getenv('SQLALCHEMY_DATABASE_URI')

    # 初始化SQLAlchemy
    db.init_app(app)

    scheduler = APScheduler()

    scheduler.api_enabled = True
    scheduler.init_app(app)

    @scheduler.task('cron',id='do_job_1', hour=17, misfire_grace_time=900)
    def job1():
        with scheduler.app.app_context():
            user_data = User.query.with_entities(User.phone_number).filter_by(gratitude_text_opt_in_status=True).all()
            gratitude_opted_in_user_list = user_data
        print(user_data)
        get_gratitude_opted_in_users_and_send_to_all(gratitude_opted_in_user_list)

    scheduler.start()

    # 导入蓝图
    from .views import views
    from .auth import auth

    # 注册蓝图
    app.register_blueprint(views, url_prefix='/')
    app.register_blueprint(auth, url_prefix='/')

    # 导入模型
    from .models import User, Note

    # 创建数据库表
    with app.app_context():
        db.create_all()

    # 初始化登录管理器
    login_manager = LoginManager()
    login_manager.login_view = 'auth.login'
    login_manager.init_app(app)

    # 用户加载函数
    @login_manager.user_loader
    def load_user(id):
        return User.query.get(int(id))

    return app

排查与解决建议 #

1. 数据库连接问题 #

• 检查Cloud SQL授权：确认App Engine服务账号已被添加到Cloud SQL实例的授权列表，拥有Cloud SQL Client角色。
• 修复URI格式：app.yaml中SQLALCHEMY_DATABASE_URI的? unix_socket存在多余空格，改为?unix_socket，避免连接解析错误。
• 移除本地数据库逻辑：create_database函数是针对本地SQLite的逻辑，部署到GCP后完全无用，且path.exists判断会失效，直接注释或删除该函数及相关调用。

2. APScheduler启动问题 #

• 调整启动顺序：把scheduler.start()放到所有蓝图、模型导入完成之后，避免job1中调用User模型时出现未加载的错误。
• 禁用Scheduler API：生产环境不需要scheduler.api_enabled = True，设置为False减少启动负载和不必要的端点暴露。
• 使用线程池执行器：保持APScheduler默认的threadpool执行器，避免使用进程池引发App Engine环境兼容性问题。

3. 部署超时优化 #

• 提升资源配置：当前memory_gb: 0.5过小，应用初始化可能因内存不足超时，调整为memory_gb: 1。
• 删除本地.env加载：App Engine Flex通过app.yaml配置环境变量，无需调用load_dotenv()，删除该语句避免无效IO操作。
• 核对依赖包：确保requirements.txt包含mysqlclient（MySQL连接依赖）、flask-apscheduler、gunicorn等所有必要包，避免部署时依赖缺失。

4. 日志定位问题 #

部署时开启调试日志：

gcloud app deploy --verbosity=debug

部署后查看实时日志：

gcloud app logs tail -s default

通过日志确定具体错误，比如数据库连接失败、依赖缺失、Scheduler初始化报错等。

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