ASP.NET Core 6 Web API：wwwroot静态文件可路由但cshtml中无法访问

核心问题 #

~/images/img.png是ASP.NET Core的服务器端路径约定，只有Web服务器处理请求时才会解析为实际绝对路径。但你的流程是把cshtml编译成静态HTML字符串后发送邮件，邮件客户端无法识别~/符号，因此无法加载图片。

解决方案 #

1. 手动替换路径为绝对URL #

在编译模板后，将所有~/替换为应用的根URL（本地测试用https://localhost:56180，部署到AKS后用实际公网域名）。

示例代码：

// 编译得到的HTML字符串
var compiledHtml = razorEngine.CompileAndRender(templateContent, model);
// 从环境变量读取根URL，本地默认值兜底
var baseUrl = Environment.GetEnvironmentVariable("APP_BASE_URL") ?? "https://localhost:56180";
// 替换路径
var finalHtml = compiledHtml.Replace("~/", $"{baseUrl}/");

部署到AKS时，通过环境变量APP_BASE_URL配置公网域名，避免硬编码。

2. 在Razor模板中直接使用绝对URL（推荐） #

修改cshtml模板，用模型传递完整的图片基础URL，编译时自动填充：

模板（wwwroot/Templates/xxx.cshtml）：

<img src="@Model.ImageBaseUrl/images/img.png" />

后台代码：

var model = new {
    ImageBaseUrl = Environment.GetEnvironmentVariable("APP_BASE_URL") ?? "https://localhost:56180",
    // 其他业务模型数据
};
var finalHtml = razorEngine.CompileAndRender(templateContent, model);

3. 嵌入图片为Base64（适合小图片） #

如果不想依赖外部资源，可将图片转换为Base64编码嵌入HTML，邮件无需联网就能显示图片：

后台代码：

// 读取wwwroot下的图片文件
var imagePath = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "images", "img.png");
var imageBytes = File.ReadAllBytes(imagePath);
var base64Image = Convert.ToBase64String(imageBytes);
var imageSrc = $"data:image/png;base64,{base64Image}";

// 传入模型
var model = new { ImageSrc = imageSrc };
var finalHtml = razorEngine.CompileAndRender(templateContent, model);

模板中使用：

<img src="@Model.ImageSrc" />

额外注意事项 #

• 部署到AKS时，确保app.UseStaticFiles()中间件配置正常，且Ingress规则允许访问/images/*路径。
• 部分邮件客户端会默认屏蔽外部图片，测试时需手动允许加载；正式环境建议配置邮件服务器的DKIM/SPF规则，提升邮件信任度，避免图片被拦截。

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