Docker化Vue.js应用后访问出现ERR_CONNECTION_REFUSED错误

按出现概率从高到低排查，最快定位问题：

1. 确认容器启动时的端口映射配置 #

• Docker容器默认运行在独立的内部网络，不会主动把端口暴露给主机，你Dockerfile里写的EXPOSE 8080仅为镜像声明标识，不会自动完成端口映射。
• 你要通过localhost:8000访问服务，启动容器时必须显式指定-p参数完成端口映射，格式为docker run -d -p 8000:8080 <你的构建镜像名>。很多人启动时漏写这个参数，导致主机根本无法连通容器内的服务，自然触发连接拒绝。

2. 检查http-server的监听配置 #

• 即使配置了正确的端口映射，也可能因为http-server默认绑定容器内部的127.0.0.1回环地址，导致外部网络请求无法触达服务。
• 修改Dockerfile中的启动命令，显式指定服务绑定所有网卡、固定服务端口：

# 替换原有CMD行
CMD ["http-server", "dist", "-a", "0.0.0.0", "-p", "8080"]

• 重新构建镜像后启动，即可保证容器内服务可以被Docker的端口映射通道正常访问。

3. 确认容器正常运行没有异常退出 #

• 很多时候镜像构建完成直接启动，容器会因为运行时错误直接退出，此时访问服务必然连接失败。
• 执行docker ps -a查看对应容器的状态，如果状态为Exited，就执行docker logs <容器ID>查看退出原因，常见异常包括：
  • 项目构建阶段没有正常生成dist目录，http-server找不到静态文件目录直接启动失败
  • 本地架构和镜像架构不匹配，比如ARM架构设备上构建的镜像直接在x86服务器运行，启动即崩溃
  • npm依赖安装异常，导致npm run build阶段失败，镜像内没有可启动的静态资源

4. 排除主机侧的端口冲突 #

• 如果上述配置都检查过还是不通，先确认本地主机的8000端口是否被其他进程占用：如果本地其他服务已经占了8000端口，Docker启动时会因为端口绑定失败直接退出容器，此时可以换一个未被占用的主机端口重新映射，比如用-p 9000:8080启动后访问localhost:9000测试。
• 检查是否给容器配置了host网络模式：如果启动时加了--network=host参数，容器内的端口会直接和主机端口打通，此时容器内http-server监听的是8080，你去访问8000自然连接失败，要么直接访问8080端口，要么修改http-server的启动端口为8000匹配你的访问地址。

内容的提问来源于stack exchange，提问作者A.K.M. Adib