搭建canvas-sketch环境时连接localhost被拒绝如何解决
2026-9-23
canvas-sketch localhost:9966 连接拒绝排查步骤
1. 确认服务实际启动状态
- 查看运行项目的终端输出，确认是否存在
[canvas-sketch] Server running at http://localhost:9966/的成功提示。如果终端存在报错信息，优先根据报错内容排查，常见启动报错原因包括依赖缺失、端口预先被占用。
2. 排查端口占用情况
- Windows系统打开cmd执行命令：
netstat -ano | findstr "9966" - macOS/Linux系统执行命令：
lsof -i :9966 - 若命令返回结果说明9966端口已被其他进程占用，可终止占用进程，或启动canvas-sketch时指定其他端口：
canvas-sketch 你的脚本文件名.js --port 自定义端口号，示例：canvas-sketch sketch.js --port 8080
3. 调整服务绑定地址
- 若使用WSL、虚拟机、远程服务器运行项目，启动时需要指定绑定所有网卡地址，执行命令：
canvas-sketch 你的脚本文件名.js --host 0.0.0.0，使用对应环境的IP加端口访问即可。 - 可尝试直接访问
127.0.0.1:9966替代localhost，排除本地hosts文件配置异常导致的域名解析失败问题。
4. 校验依赖与运行方式
- 若你是项目局部安装canvas-sketch，需使用npx调用启动命令：
npx canvas-sketch-cli 你的脚本文件名.js，避免全局命令缺失导致的服务启动失败。 - 可删除项目下的
node_modules文件夹、package-lock.json/yarn.lock文件，重新执行npm install安装全量依赖后再次启动服务测试。
5. 新建空白项目验证
- 执行命令
canvas-sketch test.js --new生成官方默认模板项目，启动后查看是否能正常访问端口，排除原有项目配置错误的问题。
内容的提问来源于stack exchange，提问作者Angelo Rena
相关产品推荐
相关产品推荐
