Windows Server 2016开机时ServiceController.DisplayName返回ServiceName的解决办法咨询

这个问题我在维护类似的服务管理架构时也踩过坑——Windows Server 2016在服务启动的初始化阶段，确实会出现ServiceController.DisplayName暂时返回ServiceName的情况，导致按配置文件里的DisplayName匹配服务失败。下面分享几个我亲测有效的变通方案：

方案1：配置文件同时存储DisplayName和ServiceName，双重匹配 #

ServiceName是服务的唯一标识，且在服务启动的任何阶段都能正确返回，不会出现DisplayName的 fallback 问题。你可以在配置文件中给每个需要管理的服务同时配置DisplayName和ServiceName，主服务优先用DisplayName查找，失败后再用ServiceName兜底匹配。

示例代码（C#）：

private ServiceController GetTargetService(string configDisplayName, string configServiceName)
{
    // 优先按DisplayName匹配
    var matchByDisplayName = ServiceController.GetServices()
        .FirstOrDefault(s => string.Equals(s.DisplayName, configDisplayName, StringComparison.OrdinalIgnoreCase));
    
    if (matchByDisplayName != null)
        return matchByDisplayName;

    // 兜底按ServiceName匹配
    return ServiceController.GetServices()
        .FirstOrDefault(s => string.Equals(s.ServiceName, configServiceName, StringComparison.OrdinalIgnoreCase));
}

方案2：增加重试机制+状态校验 #

主服务开机启动后，不要立刻执行服务管理操作，而是循环重试，直到目标服务的DisplayName正常返回（即不等于ServiceName），或者达到超时阈值。这样可以等服务完成初始化，DisplayName属性恢复正常。

示例代码（C#）：

private ServiceController WaitForValidDisplayName(string targetDisplayName, int maxRetries = 12, int retryIntervalMs = 5000)
{
    int retryCount = 0;
    while (retryCount < maxRetries)
    {
        var service = ServiceController.GetServices()
            .FirstOrDefault(s => string.Equals(s.DisplayName, targetDisplayName, StringComparison.OrdinalIgnoreCase));
        
        // 检查DisplayName是否已正常返回（不等于ServiceName）
        if (service != null && !string.Equals(service.DisplayName, service.ServiceName, StringComparison.OrdinalIgnoreCase))
        {
            return service;
        }

        Thread.Sleep(retryIntervalMs);
        retryCount++;
    }

    throw new TimeoutException($"无法找到DisplayName为{targetDisplayName}的服务，已重试{maxRetries}次");
}

方案3：直接读取注册表获取DisplayName #

服务的DisplayName实际存储在系统注册表中，即使服务处于启动中，注册表的值也是稳定的。你可以通过读取注册表项来获取服务的真实DisplayName，再和配置值匹配。需要注意主服务要有读取注册表的权限。

示例代码（C#）：

using Microsoft.Win32;

private string GetServiceDisplayNameFromRegistry(string serviceName)
{
    using (var serviceKey = Registry.LocalMachine.OpenSubKey($"SYSTEM\\CurrentControlSet\\Services\\{serviceName}"))
    {
        return serviceKey?.GetValue("DisplayName") as string;
    }
}

private ServiceController FindServiceByDisplayName(string targetDisplayName)
{
    foreach (var service in ServiceController.GetServices())
    {
        var actualDisplayName = GetServiceDisplayNameFromRegistry(service.ServiceName);
        if (string.Equals(actualDisplayName, targetDisplayName, StringComparison.OrdinalIgnoreCase))
        {
            return service;
        }
    }
    return null;
}

方案4：配置服务依存关系 #

如果主服务管理的服务都是开机必须启动的，可以在主服务的属性中设置“依存关系”，让主服务在这些目标服务之后启动。这样系统会保证目标服务完成初始化后，再启动主服务，从根源上避免DisplayName未就绪的问题。不过这个方案只适用于主服务必须依赖目标服务启动的场景，灵活性较低。

你可以根据自己的业务场景选择合适的方案：如果能修改配置文件存储ServiceName，方案1最省心；如果只能依赖DisplayName，方案2或3更可靠；如果服务启动顺序固定，方案4最彻底。

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