Docker环境下ASP.NET Core连接Redis失败的配置问题咨询

1. 修正Redis连接字符串格式 #

你的报错核心是连接字符串语法不符合StackExchange.Redis的要求：

• 错误原因：混合使用逗号/分号作为参数分隔符，或在参数值后额外添加标点，导致解析失败
• 正确格式示例：
  • 分号分隔参数：Redis:6379;defaultDatabase=0
  • 逗号分隔参数：Redis:6379,defaultDatabase=0
    注意：不要同时混用逗号和分号，参数值末尾不要加多余标点。

2. 解决Docker容器间网络访问问题 #

当ASP.NET Core应用和Redis都通过Docker（尤其是docker-compose）启动时：

• 不能用localhost作为Redis主机名：每个容器的localhost指向自身网络栈，无法访问其他容器
• 必须使用docker-compose中Redis服务的名称（比如你的服务名是Redis）作为主机名：docker-compose会自动在内部网络中解析该名称到Redis容器的IP

3. 完整配置示例 #

在ASP.NET Core的appsettings.json中配置正确的连接字符串：

{
  "ConnectionStrings": {
    "Redis": "Redis:6379;defaultDatabase=0"
  }
}

在Program.cs中注册Redis服务（.NET 6+示例）：

builder.Services.AddStackExchangeRedisCache(options =>
{
    options.Configuration = builder.Configuration.GetConnectionString("Redis");
});

4. 验证docker-compose网络配置 #

确保ASP.NET Core应用和Redis服务处于同一网络（docker-compose默认会创建共享网络），示例docker-compose.yml片段：

version: '3.8'
services:
  redis:
    image: redis:latest
    container_name: Redis
    ports:
      - "6379:6379"
  aspnetapp:
    build: .
    container_name: AspNetCoreApp
    ports:
      - "8080:80"
    depends_on:
      - redis

depends_on确保Redis优先启动，两个服务共享默认网络，ASP.NET Core应用可通过redis服务名访问Redis容器。

内容的提问来源于stack exchange，提问作者Jaczura Zoltán