You need to enable JavaScript to run this app. Python socket.io服务本地socket.io.js 404、io未定义问题排查
优惠活动
大模型
产品
解决方案
定价
更多

Python socket.io服务本地socket.io.js 404、io未定义问题排查

404报错的根本原因

你当前的所有操作失效,核心是混淆了两个完全不同技术栈的Socket.IO服务行为:

  • 你之前参考的两个排障场景都是基于Node.js环境的socket.io服务,这类服务设计上会自动托管路径为/socket.io/socket.io.js的客户端静态资源,访问对应路径即可拿到匹配版本的js文件
  • 你通过pip安装的python-socketio库,也就是现在在跑的aiohttp服务,从设计上就没有自动托管客户端js文件的功能。它挂在/socket.io/前缀下的路由仅处理WebSocket连接、消息轮询的接口请求,不会响应对静态js文件的访问
  • 你后续通过npm安装的node_modules目录,Python服务从来没有配置过对应路由去读取这个目录下的文件,所以不管你把js路径写成/socket.io/socket.io.js还是/node_modules/socket.io/socket.io.js,aiohttp收到请求时都找不到对应的资源,自然返回404
可直接运行的落地方案

用库自带的匹配版本js做本地托管(无版本兼容风险)

完全不需要去CDN下载文件、不需要用npm安装Node版的依赖,python-socketio安装完成后本身就内置了和服务端100%兼容的客户端js文件,步骤如下:

  • 在项目根目录新建static文件夹,专门用来存放静态资源
  • 打开终端执行命令,定位本地安装的python-socketio包的存放路径:
    python -c "import socketio; print(socketio.__file__)"
  • 顺着终端输出的路径,进到python-socketio包的目录,找到client_info子文件夹,把里面的socket.io.min.js直接拷到刚才新建的static文件夹下
  • 修改server.py,给aiohttp增加静态资源路由,让服务能响应static目录下的文件请求,修正后的完整代码参考:
    from aiohttp import web
    import socketio
    
    sio = socketio.AsyncServer(cors_allowed_origins="*")
    app = web.Application()
    sio.attach(app)
    
    # 新增静态资源路由:所有以/static/开头的请求,都会映射到本地static文件夹
    app.router.add_static('/static/', path='./static/', name='static')
    
    async def index(request):
        with open('index.html') as f:
            return web.Response(text=f.read(), content_type='text/html')
    
    @sio.on('message')
    async def print_message(sid, message):
        print("Socket ID-: " , sid)
        print(message)
        await sio.emit('message', message[::-1])
    
    app.router.add_get('/', index)
    
    if __name__ == '__main__':
        web.run_app(app, port=8080)
    
  • 修改index.html的script引入逻辑,删掉原来的CDN地址、错误的本地路径,换成自己托管的静态文件路径:
    <button onClick="sendMsg()">Hit Me</button>
    <!-- 用相对路径引入本地托管的js文件 -->
    <script src="/static/socket.io.min.js"></script>
    <script>
        <!-- 页面和js资源都是从同一个8080端口加载的,直接初始化即可,不需要写全localhost地址 -->
        const socket = io();
        function sendMsg() {
            socket.emit("message", "HELLO WORLD");
        }
        socket.on("message", function(data) {
            console.log(data);
        });
    </script>
    
高频踩坑提醒
  • 版本必须严格匹配:python-socketio v5.x版本必须搭配同大版本的客户端js文件。之前你用CDN引入的v2.2.0版本脚本能跑,只是兼容层的临时适配,本地托管时如果版本不匹配,就算文件加载成功也会出现连接失败、消息收发异常的问题
  • 不要依赖“服务自动托管js”的Node版经验:Python版服务不会自动在/socket.io/路径返回js文件,所有静态资源都需要手动写aiohttp路由映射
  • 不要在script的src中写全http://localhost:8080的绝对路径:用相对路径引入资源,后续服务更换端口、调整部署地址时不会出现路径失效的问题

内容的提问来源于stack exchange,提问作者christian

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 10:06:01