使用Catalyst CLI运行advanced-io函数时遇“Unable to serve request”错误排查
Zoho Catalyst Advanced-IO本地测试“Unable to reach server”/“Unable to serve request”问题排查
- 本地服务未正常启动或端口冲突:先确认是否执行了
catalyst serve命令,终端需显示服务在指定端口(默认9000)正常运行。若端口被占用,用catalyst serve -p <空闲端口>切换端口,测试时要使用对应端口的URL。 - 函数配置文件参数错误:检查
catalyst.json或函数目录下的配置文件,确保function_type设为advanced-io,runtime版本(如Node.js 16、Python 3.9)与本地环境匹配,且handler路径正确指向入口文件和函数(例如Node.js的index.handler)。 - 依赖未安装或版本不兼容:进入函数目录,执行对应语言的依赖安装命令——Node.js用
npm install,Python用pip install -r requirements.txt,确保所有依赖安装完整,且版本符合Catalyst支持范围。 - 防火墙或代理拦截请求:本地防火墙可能阻断了服务端口通信,可暂时关闭防火墙测试;若使用代理,需配置Catalyst CLI绕过代理,或确保代理允许访问本地服务端口。
- 代码逻辑存在异常:检查代码中是否有未捕获的错误、无效的外部网络请求(如本地无网络时调用外部接口),或入口函数参数处理错误。可在代码中添加日志输出,通过
catalyst logs查看本地运行日志定位问题。 - Catalyst CLI版本过旧:执行
catalyst --version查看版本,若不是最新版,用npm update -g zcatalyst-cli(Node.js环境)更新CLI,旧版本可能存在本地服务兼容性问题。
内容的提问来源于stack exchange,提问作者Alexander Reed
相关产品推荐
相关产品推荐

