Flask-SocketIO应用初始化两次，此现象是否属于典型行为？

首先，你用的这种「全局SocketIO实例 + Flask工厂函数」的模式，其实是Flask-SocketIO官方推荐的实践方式之一，正常情况下只会完成一次初始化。出现两次初始化的情况，大概率是代码的其他环节触发了重复调用，下面是最常见的几个原因和对应的排查/解决方法：

可能的原因1：create_app被调用了两次 #

你可以先在create_app函数开头加一行调试打印，确认它是不是被执行了两次：

def create_app(address, port):
    # 给函数加个调用计数属性，方便追踪
    if not hasattr(create_app, 'call_count'):
        create_app.call_count = 0
    create_app.call_count += 1
    print(f"Creating app - 这是第 {create_app.call_count} 次调用")
    
    app = Flask(__name__, static_url_path='')
    app.config.from_pyfile('config.py')
    __socketIO__.init_app(app)
    return app

如果打印输出了两次，那你需要去检查启动脚本、测试代码或者其他导入了这个函数的模块，看看是不是不小心重复调用了create_app——比如有些新手会在启动脚本里先调用一次create_app配置路由，又调用一次启动服务，这种情况就会导致重复初始化。

可能的原因2：Flask Debug模式的重载器在搞鬼 #

如果你是用Debug模式启动应用（debug=True），Flask默认会启动一个重载器进程来监控文件变化，当文件修改时自动重启应用。这时候会有两个进程：一个是监控用的重载器进程，一个是实际运行应用的子进程。

你的全局__socketIO__实例是在模块级别声明的，所以两个进程都会初始化这个实例——这会让你误以为是「应用初始化了两次」，但实际上是两个独立的进程各自完成了一次初始化。

解决这个问题的方法有两个：

1. 启动时关闭重载器：

   # 在你的启动脚本里
   from test_app.configs import create_app, __socketIO__
   
   if __name__ == '__main__':
       app = create_app('0.0.0.0', 5000)
       __socketIO__.run(app, host='0.0.0.0', port=5000, use_reloader=False)
   

2. 调整代码结构，把SocketIO的实例化移到启动脚本的if __name__ == '__main__':块里，避免重载器进程执行初始化逻辑。

可能的原因3：__socketIO__.init_app被单独调用了两次 #

除了create_app里的调用，有没有可能在其他地方又调用了一次__socketIO__.init_app绑定另一个Flask实例？比如某些路由模块或者扩展初始化代码里不小心重复调用了这个方法。

你可以给__socketIO__.init_app加个包装，追踪调用次数：

from flask_socketio import SocketIO

__socketIO__ = SocketIO()
# 包装init_app方法，添加调用计数
original_init_app = __socketIO__.init_app
__socketIO__.init_app_call_count = 0

def wrapped_init_app(app, **kwargs):
    __socketIO__.init_app_call_count += 1
    print(f"SocketIO init_app 被调用了 {__socketIO__.init_app_call_count} 次")
    return original_init_app(app, **kwargs)

__socketIO__.init_app = wrapped_init_app

这样就能清楚看到是不是init_app被重复调用了。

总结 #

你的代码结构本身是合理的，两次初始化不是这种模式的典型行为。优先排查create_app的调用次数和Debug模式的重载器问题，这两个是最常见的诱因。

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