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
相关产品推荐
相关产品推荐

