Blazor Server项目中Telerik Report Viewer连接字符串配置问题

核心问题定位 #

你配置的WebReportDesignerSettings.json是Telerik Web Report Designer的本地客户端配置文件，仅用于设计器的预览环境，Blazor Server项目的Report Viewer后端服务（即/api/reportdesigner对应的控制器）不会读取这个文件。连接字符串必须配置在Blazor Server应用自身的配置文件中。

分步排查方案 #

1. 将连接字符串移至Blazor Server的应用配置文件 #

把连接字符串添加到项目的appsettings.json（或appsettings.Development.json）中：

{
  "ConnectionStrings": {
    "TelerikConnectionString": "Server=.;Initial Catalog=AdventureWorks;Integrated Security=true"
  }
}

注意：Server=.\\写法冗余，简化为Server=.即可，避免转义符可能带来的解析问题

2. 确保Reporting服务正确读取应用配置 #

在Program.cs中确认Telerik Reporting服务已正确配置并绑定到应用配置：

var builder = WebApplication.CreateBuilder(args);

// 添加Controllers并集成Telerik Reporting服务
builder.Services.AddControllers().AddTelerikReporting();

// 确保配置文件被加载（默认已包含，但若有自定义配置需确认）
builder.Configuration.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);

var app = builder.Build();

// 启用路由和Controllers
app.UseRouting();
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
});

app.Run();

3. 验证报表的数据源配置 #

打开你的Telerik报表文件（.trdx或.trdp），检查数据源的连接设置：

• 如果报表使用命名连接字符串：确保数据源的ConnectionString属性选择的是TelerikConnectionString，与appsettings中的名称完全一致
• 如果报表使用自定义连接字符串：则需要在ReportSource参数中传递完整的连接字符串值，而非名称，修改代码如下：

  private ReportSourceOptions Source => new()
  {
      Report = SelectedReport?.Name ?? string.Empty,
      Parameters = new Dictionary<string, object>()
      {
          { "ConnectionString" , "Server=.;Initial Catalog=AdventureWorks;Integrated Security=true" }
      }
  };
  

4. 检查运行权限 #

如果使用Integrated Security=true，需确保Blazor Server的运行账户（IIS应用池账户或本地调试时的当前用户）拥有访问AdventureWorks数据库的权限：

• 本地调试：确认当前Windows用户能通过SSMS连接到目标数据库
• IIS部署：将应用池身份设置为具有数据库访问权限的账户（如域账户或本地管理员）

5. 查看详细错误日志 #

启用Telerik Reporting的详细日志，获取更精确的错误信息：
在appsettings.json中添加日志配置：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Telerik.Reporting": "Debug",
      "Telerik.Reporting.Services": "Debug"
    }
  }
}

运行项目后查看控制台或日志文件，找到连接失败的具体原因（如找不到连接串、权限不足等）

内容的提问来源于stack exchange，提问作者Hakan Fıstık