如何自动检查ASP.NET Web Forms多服务器页面部署版本一致性？

针对手动部署后无法核查多服务器文件一致性的问题，推荐整合版本标识与文件哈希的双重验证方案，兼顾直观性与准确性，具体实现如下：

一、核心实现思路 #

1. 编译/发布阶段自动生成验证依据 #

• 版本号自动注入：
  在项目的AssemblyInfo.cs中配置自动递增的程序集版本，比如[assembly: AssemblyVersion("1.0.*")]，让每次编译自动生成唯一修订号；如果用CI/CD工具发布，可直接注入构建编号作为版本号。
  对于ASPX/ASCX页面，在代码后置类或页面模板中添加版本输出逻辑，比如在后台管理页的隐藏区域渲染当前程序集版本：

  <div style="display:none;">当前版本：<%= System.Reflection.Assembly.GetExecutingAssembly().GetName().Version.ToString() %></div>
  

• 生成文件哈希清单：
  发布更新包时，自动遍历所有关键文件（DLL、ASPX、ASCX、Web.config等），计算每个文件的SHA256哈希值，将文件名、相对路径、哈希值、版本号存入JSON清单文件（如deploy-manifest.json），随更新包一同交付客户。

2. 后台管理页的验证模块 #

在后台管理页添加部署验证功能，实现以下逻辑：

• 读取服务器上的deploy-manifest.json清单文件；
• 获取当前服务器标识（如Environment.MachineName），方便客户区分多冗余节点；
• 遍历清单中的每个文件，计算服务器上对应文件的哈希值，与清单值比对；
• 直观展示验证结果：用颜色区分匹配/不匹配项，列出文件名、预期版本、实际版本、哈希比对状态。

二、多服务器环境优化 #

• 让管理页显示当前请求所在服务器的标识，客户可通过刷新页面切换服务器节点，逐一验证；
• 可选添加定时校验任务：后台自动执行哈希比对，记录异常日志，客户可在管理页查看历史校验记录。

三、代码示例 #

发布时生成哈希清单（C#控制台工具） #

using System;
using System.IO;
using System.Security.Cryptography;
using System.Text.Json;
using System.Collections.Generic;

class ManifestGenerator
{
    static void Main(string[] args)
    {
        var packagePath = @"D:\YourReleasePackage";
        var targetPatterns = new List<string> { "*.dll", "*.aspx", "*.ascx", "Web.config" };
        var manifestEntries = new List<FileManifestEntry>();
        var currentVersion = System.Reflection.Assembly.GetExecutingAssembly().GetName().Version.ToString();

        foreach (var pattern in targetPatterns)
        {
            foreach (var file in Directory.GetFiles(packagePath, pattern, SearchOption.AllDirectories))
            {
                var relativePath = Path.GetRelativePath(packagePath, file);
                using var sha256 = SHA256.Create();
                using var stream = File.OpenRead(file);
                var hashBytes = sha256.ComputeHash(stream);
                var hashString = BitConverter.ToString(hashBytes).Replace("-", "").ToLowerInvariant();

                manifestEntries.Add(new FileManifestEntry
                {
                    FilePath = relativePath,
                    Sha256Hash = hashString,
                    Version = currentVersion
                });
            }
        }

        var manifestPath = Path.Combine(packagePath, "deploy-manifest.json");
        File.WriteAllText(manifestPath, JsonSerializer.Serialize(manifestEntries, new JsonSerializerOptions { WriteIndented = true }));
    }
}

public class FileManifestEntry
{
    public string FilePath { get; set; }
    public string Sha256Hash { get; set; }
    public string Version { get; set; }
}

后台管理页的验证逻辑 #

protected void btnValidate_Click(object sender, EventArgs e)
{
    var manifestPath = Server.MapPath("~/deploy-manifest.json");
    if (!File.Exists(manifestPath))
    {
        lblStatus.Text = "部署清单文件不存在";
        return;
    }

    var manifest = JsonSerializer.Deserialize<List<FileManifestEntry>>(File.ReadAllText(manifestPath));
    var serverId = Environment.MachineName;
    var currentVersion = System.Reflection.Assembly.GetExecutingAssembly().GetName().Version.ToString();
    var resultTable = new System.Web.UI.WebControls.Table();
    resultTable.CssClass = "validation-table";

    // 添加表头
    var headerRow = new System.Web.UI.WebControls.TableRow();
    headerRow.Cells.Add(new System.Web.UI.WebControls.TableCell { Text = "服务器" });
    headerRow.Cells.Add(new System.Web.UI.WebControls.TableCell { Text = "文件路径" });
    headerRow.Cells.Add(new System.Web.UI.WebControls.TableCell { Text = "预期版本" });
    headerRow.Cells.Add(new System.Web.UI.WebControls.TableCell { Text = "版本匹配" });
    headerRow.Cells.Add(new System.Web.UI.WebControls.TableCell { Text = "哈希匹配" });
    resultTable.Rows.Add(headerRow);

    foreach (var entry in manifest)
    {
        var filePath = Server.MapPath($"~/{entry.FilePath}");
        var versionMatch = currentVersion == entry.Version;
        var hashMatch = false;

        if (File.Exists(filePath))
        {
            using var sha256 = SHA256.Create();
            using var stream = File.OpenRead(filePath);
            var hashBytes = sha256.ComputeHash(stream);
            var currentHash = BitConverter.ToString(hashBytes).Replace("-", "").ToLowerInvariant();
            hashMatch = currentHash == entry.Sha256Hash;
        }

        var row = new System.Web.UI.WebControls.TableRow();
        row.Cells.Add(new System.Web.UI.WebControls.TableCell { Text = serverId });
        row.Cells.Add(new System.Web.UI.WebControls.TableCell { Text = entry.FilePath });
        row.Cells.Add(new System.Web.UI.WebControls.TableCell { Text = entry.Version });
        row.Cells.Add(new System.Web.UI.WebControls.TableCell 
        { 
            Text = versionMatch ? "✅" : "❌", 
            CssClass = versionMatch ? "success" : "error" 
        });
        row.Cells.Add(new System.Web.UI.WebControls.TableCell 
        { 
            Text = hashMatch ? "✅" : "❌", 
            CssClass = hashMatch ? "success" : "error" 
        });
        resultTable.Rows.Add(row);
    }

    pnlResults.Controls.Add(resultTable);
}

public class FileManifestEntry
{
    public string FilePath { get; set; }
    public string Sha256Hash { get; set; }
    public string Version { get; set; }
}

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