Docker-Compose部署SvelteKit应用无法连接Redis问题排查

1. 服务启动顺序不匹配 #

Docker Compose默认会并行启动所有服务，SvelteKit应用启动时，Redis可能还没完成初始化就绪，此时应用尝试连接就会触发拒绝错误——哪怕你代码里写的是正确的服务名redis，也会因为Redis服务未就绪而连接失败。

解决方法：
在docker-compose.yaml中给SvelteKit服务添加依赖和健康检查配置，确保Redis完全就绪后再启动应用：

services:
  redis:
    image: redis:latest
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 3s
      retries: 5
  sveltekit-app:
    build: .
    depends_on:
      redis:
        condition: service_healthy

2. 应用实际连接地址被环境变量覆盖 #

虽然代码里写了redis://redis:6379，但如果应用同时有读取环境变量的逻辑（比如优先用process.env.REDIS_URL），而这个环境变量被设置成了redis://127.0.0.1:6379（比如本地开发残留的配置），就会导致容器内的应用尝试连接本地而非Redis服务。

解决方法：

• 检查应用代码是否存在环境变量优先的逻辑，比如：

const redisUrl = process.env.REDIS_URL || 'redis://redis:6379';
const redis = new Redis({ url: redisUrl });

• 若存在，在docker-compose.yaml中给SvelteKit服务明确设置环境变量：

services:
  sveltekit-app:
    build: .
    environment:
      - REDIS_URL=redis://redis:6379

3. Docker网络配置异常 #

如果手动修改了Compose的网络配置，导致SvelteKit和Redis不在同一个网络中，应用就无法通过服务名redis访问到Redis容器。

解决方法：
检查docker-compose.yaml的网络配置，确保两个服务处于同一网络（默认Compose会自动创建默认网络，所有服务自动加入；若使用自定义网络，需确保两个服务都引用该网络）：

networks:
  app-network:
    driver: bridge

services:
  redis:
    image: redis:latest
    networks:
      - app-network
  sveltekit-app:
    build: .
    networks:
      - app-network

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