GitHub Codespaces中Inertia.js端口5173资源加载失败（ERR_CONNECTION_REFUSED）求助

一、基础端口配置检查 #

• 确认项目服务正在监听5173端口。终端执行lsof -i :5173（Linux/macOS）或netstat -ano | findstr :5173（Windows），查看是否有进程占用该端口。若没有，启动服务时明确指定端口，比如Vite项目用vite --port 5173。
• 检查Codespaces端口转发设置：打开左侧边栏Ports标签，确认5173端口已转发，状态为“Public”或“Private”。未显示则手动添加：点击“Add Port”输入5173，选择访问权限。

二、调整服务绑定地址 #

多数本地开发服务默认绑定localhost，但Codespaces需绑定0.0.0.0才能被外部访问，修改项目配置：

• Vite项目：在vite.config.js中添加server.host: '0.0.0.0'
• Vue CLI项目：在vue.config.js中设置devServer.host: '0.0.0.0'
• 修改后重启服务，再尝试访问资源。

三、替代端口方案 #

若5173端口冲突或配置无效，更换其他端口：

• 启动服务时指定新端口，比如vite --port 3000
• 在Codespaces的Ports标签添加新端口，确保服务绑定0.0.0.0，之后用新端口加载资源。

四、防火墙与权限检查 #

• 确认Codespaces环境无防火墙规则拦截5173端口，执行sudo ufw status查看状态，若开启则添加规则sudo ufw allow 5173/tcp。
• 检查服务启动权限，避免因权限不足无法监听端口。

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