.NET MAUI Blazor集成Telerik报表设计器遇CORS报错求助

场景：将Telerik Web报表设计器集成到Blazor .NET MAUI混合应用，尝试查看已创建报表时，反复出现错误：
Make sure the service address is correct and enable CORS if needed. (https://enable-cors.org)
已配置CORS但问题未解决，后端核心配置代码如下：

// 报表服务配置
builder.Services.AddSingleton<IReportServiceConfiguration>(sp => new ReportServiceConfiguration
{
    ReportingEngineConfiguration = sp.GetService<IConfiguration>(),
    HostAppId = "newcumstomreportAPI",
    Storage = new FileStorage(),
    ReportSourceResolver = new UriReportSourceResolver(
        Path.Combine(Environment.CurrentDirectory, "Reports"))
});
builder.Services.AddSingleton<IReportDesignerServiceConfiguration>(sp => new ReportDesignerServiceConfiguration
{
    DefinitionStorage = new FileDefinitionStorage(Path.Combine(Environment.CurrentDirectory, "Reports")),
    SettingsStorage = new FileSettingsStorage(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "Telerik Reporting")),
    ResourceStorage = new ResourceStorage(Path.Combine(Environment.CurrentDirectory, "Resources"))
});

// CORS配置
builder.Services.AddCors();

var app = builder.Build();

app.UseStaticFiles();
//app.UseCors(MyAllowSpecificOrigins);
app.UseCors(builder =>
                builder.WithOrigins("*")
                .AllowAnyHeader()
                .AllowAnyMethod()
            );

app.UseRouting();

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
});

排查与修复步骤 #

1. 修正中间件顺序（核心问题） #

ASP.NET Core中间件顺序严格决定功能生效逻辑，CORS中间件必须放在UseRouting之后、UseEndpoints之前，否则CORS策略无法正确绑定到路由端点。修改后的中间件顺序：

app.UseStaticFiles();

app.UseRouting();

// 移到UseRouting之后
app.UseCors(builder =>
                builder.WithOrigins("*")
                .AllowAnyHeader()
                .AllowAnyMethod()
            );

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
});

2. 确保Telerik报表服务端点正确映射 #

仅调用MapControllers()可能不足以映射Telerik报表设计器的专用服务端点，需添加Telerik的报表路由映射：

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
    // 添加Telerik报表设计器服务端点
    endpoints.MapReportDesignerControllers();
    // 若需报表查看服务，同时添加
    endpoints.MapReportingControllers();
});

注意：需确保项目已引用Telerik.Reporting.Services.AspNetCore NuGet包。

3. 检查CORS配置的兼容性问题 #

• 若前端请求携带凭据（如Cookie、Token），WithOrigins("*")与AllowCredentials()无法同时使用，需指定具体的前端Origin（例如http://localhost:5000），并显式允许凭据：

app.UseCors(builder =>
                builder.WithOrigins("http://localhost:5000", "https://your-maui-app-url")
                .AllowAnyHeader()
                .AllowAnyMethod()
                .AllowCredentials()
            );

• 生产环境避免使用*作为Origin，需限制为可信域名。

4. 验证报表服务地址配置 #

前端初始化Telerik报表设计器时，需确保配置的serviceUrl与后端服务地址完全一致，包括协议、域名、端口和路径（例如/api/reportdesigner），路径需匹配后端路由映射。

5. 检查文件存储路径权限与存在性 #

• 确认Reports、Resources文件夹已创建，且应用进程拥有读写权限；
• 若路径不存在或权限不足，报表服务无法读取文件，可能触发误导性的CORS错误提示。

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