对一些常见错误进行故障排除

Last published : Oct 24, 2026
本主题列出了您在设置 Secure Private Access 时可能会遇到的一些错误。
证书错误
数据库创建错误
思杰店面故障
公共网关/回调网关故障
安全私有访问服务器不可达

证书相关的错误

错误消息：无法自动从一个或多个网关服务器获取证书。
当您尝试添加公共 NetScaler® Gateway 地址并且在获取证书时出现问题时，会出现此错误消息。此问题可能在设置 Secure Private Access 时或在设置完成后更新设置时发生。
解决方法：以与 Citrix 虚拟应用和桌面 相同的方式更新网关证书。

数据库创建错误

  • 错误消息：创建数据库失败
    解决方案：对于自动情况 - 计算机必须具有 READ、WRITE、UPDATE 权限才能在 SQL Server 上的数据库中创建表。
  • 错误消息：创建数据库失败：数据库已存在。
    此错误消息可能出现在以下任何场景中。
    • 如果在配置数据库时选择了自动配置选项。
    • 如果管理员正在创建数据库，则该数据库必须是空数据库。如果数据库不是空数据库，则可能会出现此错误消息。
      解决方案：您必须创建一个空数据库。
    • 您卸载了 Secure Private Access 并使用相同的站点名称重试设置。在这种情况下，以前安装的数据库不会被删除。
      解决方案：您必须手动删除数据库。
    • 您选择通过使用脚本手动设置数据库（通过在“配置数据库”页面中选择“手动配置”），然后更改为“自动配置”选项，但使用相同的站点名称。在这种情况下，运行脚本时已创建了同名数据库。
      解决方案：您必须重命名站点，然后再次运行脚本。
    • 该计算机没有在 SQL Server 上的数据库中创建表的 READ、WRITE、UPDATE 权限。
      解决方案：在计算机上启用相应的权限。有关详细信息，请参阅设置数据库所需的权限。
  • 错误消息：创建数据库失败：连接失败
    解决方案：
    • 检查您的计算机与数据库的网络连接。确保 SQL Server 端口在防火墙上已打开。
    • 如果使用远程 SQL 服务器，请检查 SQL 服务器是否已使用 Secure Private Access 计算机身份 Domain\hostname$ 创建登录名。
    • 如果使用远程 SQL Server，请确认计算机身份已分配正确的角色，即系统管理员角色。
    • 如果使用本地 SQL 服务器（非安装程序自带），请检查 NT AUTHORITY\SYSTEM 用户是否必须创建登录名。

StoreFront™ 故障及解决方案

  • 错误消息：未能为 <Store URL> 创建 StoreFront 条目
    如果 StoreFront 条目不可见，请从“设置”选项卡更新它们。使用向导设置 Secure Private Access 后，您可以从“设置”选项卡编辑 StoreFront 条目。记下发生此错误的 StoreFront 商店 URL。
    解决方案：
    1. 单击“设置”，然后单击“集成”选项卡。
    2. In StoreFront Store URL, add the StoreFront entry if it is not visible.
  • 错误消息：未能为 <Store URL> 配置 StoreFront 条目
    解决方案：
    1. 可能存在 PowerShell 执行策略限制。运行 PowerShell 脚本命令 Get-ExecutionPolicy 以获取详细信息。
    2. 如果受限，您必须绕过此限制并手动运行 StoreFront 配置脚本。
    3. 单击“设置”，然后单击“集成”选项卡。
    4. In StoreFront Store URL, identify the StoreFront URL entry for which the error occurred.
    5. 单击此商店 URL 旁边的“下载脚本”按钮，并在安装了相应 StoreFront 的计算机上以管理员权限运行此 PowerShell 脚本。此脚本必须在所有 StoreFront 计算机上运行。
    注意：
    如果您在卸载后重试安装，请确保 StoreFront 配置中没有名为“Secure Private Access”的条目（StoreFront > 商店 > 交付控制器™ -> Secure Private Access）。如果存在 Secure Private Access，请删除此条目。从“设置”>“集成”页面手动下载并运行脚本。
  • 错误消息：StoreFront 配置不是本地的，适用于：<Store URL>
    使用向导设置 Secure Private Access 后，您可以从“设置”选项卡编辑网关条目。记下发生此错误的 StoreFront 商店 URL。
    解决方案：
    如果 StoreFront 未与 Secure Private Access 安装在同一台计算机上，则会出现此问题。您必须在安装 StoreFront 的计算机上手动运行 StoreFront 配置。
    1. 单击“设置”，然后单击“集成”选项卡。
    2. 在StoreFront 应用商店 URL中，识别发生错误的 StoreFront 地址条目。
    3. 单击此商店 URL 旁边的“下载脚本”按钮，并在安装了相应 StoreFront 的计算机上以管理员权限运行此 PowerShell 脚本。此脚本必须在所有 StoreFront 计算机上运行。
    注意：
    To run the StoreFront PowerShell script, open the Windows x64 compatible PowerShell window with admin privileges and then run ConfigureStorefront.ps1. StoreFront script is not compatible with Windows PowerShell (x86).
  • Error message: "Get-STFStoreService : Exception of type 'Citrix.DeliveryServices.Framework.Feature.Exceptions.RegistryKeyNotFoundException' was thrown." while running StoreFront script using PowerShell.
    当在 x86 兼容的 PowerShell 窗口中运行 StoreFront 脚本时，会发生此错误。
    解决方案：
    To run the StoreFront PowerShell script, open the Windows x64 compatible PowerShell window with admin privileges and then run ConfigureStorefront.ps1.

公共网关/回调网关故障

错误消息：未能为 <Gateway URL> 创建网关条目 或 未能为 <Callback Gateway URL> 创建回调网关条目
解决方案：
记下发生故障的公共网关或回调网关 URL。使用向导设置 Secure Private Access 后，您可以从“设置”选项卡编辑网关条目。
  1. 单击“设置”，然后单击“集成”选项卡。
  2. 更新发生故障的公共网关地址或回调网关地址以及虚拟 IP 地址。

安全私有访问服务器无法访问

错误消息：未能更新 IIS 池。未能重新启动 IIS 池
解决方案：
转到 Internet Information Services (IIS) 中的应用程序池，并检查以下应用程序池是否已启动并正在运行：
  • 安全私有访问运行时池
  • 安全私有访问管理池
另请检查默认 IIS 站点 "Default Web Site" 是否已启动并正在运行。

数据库连接检查失败

错误消息： 连接检查失败
数据库连接检查可能因多种原因而失败：
  • 数据库服务器由于防火墙原因无法从 Secure Private Access 插件主机访问。
    解决方案： 检查防火墙上是否打开了数据库端口（默认端口 1433）。
  • Secure Private Access 插件主机没有连接到数据库的权限。
    解决方案： 请参阅 安全私有访问的 SQL 数据库权限。

网关连接性检查失败，未能获取公共证书

错误消息： 安装后配置失败，并显示错误“网关连接检查失败。无法获取公共证书…。”
解决方案：
  • 使用配置工具手动将网关公共证书上传到 Secure Private Access 数据库。
  • 以管理员权限打开 PowerShell 或命令提示符窗口。
  • Change the directory to the Admin\AdminConfigTool folder under the Secure Private Access installation folder (for example, cd "C:\Program Files\Citrix\Citrix Access Security\Admin\AdminConfigTool")
  • 运行以下命令：
    .\AdminConfigTool.exe /UPLOAD_PUBLIC_GATEWAY_CERTIFICATE <PublicGatewayUrl> <PublicGatewayCertificatePath>

应用程序枚举失败

如果 StoreFront URL 或 NetScaler Gateway URL 包含尾部斜杠 (/)，则应用程序枚举功能将无法正常工作。
解决方案：
Delete the trailing slash in the StoreFront store URL or the NetScaler Gateway URL. For details, see Update StoreFront or the NetScaler Gateway server details after the setup.

其他问题

创建安全私有访问故障诊断支持包

执行以下步骤以创建 Secure Private Access 诊断支持包：
  • 以管理员权限打开 PowerShell 或命令提示符窗口。
  • Change the directory to the Admin\AdminConfigTool folder under the Secure Private Access installation folder (for example, cd "C:\Program Files\Citrix\Citrix Access Security\Admin\AdminConfigTool").
  • 运行以下命令：
    .\AdminConfigTool.exe /SUPPORTBUNDLE <output folder>

安全私有访问的 SQL 数据库权限

对于自动数据库创建，Secure Private Access 插件主机必须具有连接到数据库并创建数据库架构的权限。
远程数据库：
请执行以下步骤，以配置远程数据库的权限。
  1. 使用名称语法 CitrixAccessSecurity<Site Name> 创建一个空数据库。其中 <Site Name> 是安全私有访问的站点名称。（例如：CitrixAccessSecuritySPA）。
    CREATE DATABASE CitrixAccessSecurity<SiteName>
  2. 为 Secure Private Access 虚拟机的计算机身份创建 SQL Server 登录名。例如，如果您的 Secure Private Access 代理计算机名称是 HOST1，计算机域是 DOMAIN1，则计算机身份是 "DOMAIN1\HOST1$"。如果登录名已创建，则可以忽略此步骤。
    USE CitrixAccessSecurity<SiteName>
    CREATE LOGIN [DOMAIN1\HOST1$] FROM WINDOWS
    可以使用以下查询找到域名：
    SELECT DEFAULT_DOMAIN()[DomainName]
  3. 将 db_owner 角色分配给计算机标识。
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'DOMAIN1\HOST1$'
    ALTER USER [DOMAIN1\HOST1$] WITH DEFAULT_SCHEMA = dbo;
本地数据库：
请执行以下步骤，以配置本地数据库的权限。
  1. 请创建一个空数据库，其命名应遵循 CitrixAccessSecurity<Site Name> 所定义的语法。在此处，<Site Name> 指代的是 Secure Private Access 的站点名称。（例如：CitrixAccessSecuritySPA）。
    CREATE DATABASE CitrixAccessSecurity<SiteName>
  2. 为 NT AUTHORITY\SYSTEM 用户创建 SQL Server 登录名。如果登录名已创建，则可以忽略此步骤。
    USE CitrixAccessSecurity<SiteName>
    CREATE LOGIN [NT AUTHORITY\SYSTEM] FROM WINDOWS
  3. 将数据库所有者角色分配给“NT AUTHORITY\SYSTEM”用户。
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'NT AUTHORITY\SYSTEM'
    ALTER USER [NT AUTHORITY\SYSTEM] WITH DEFAULT_SCHEMA = dbo;
当您手动创建数据库时，下载的数据库脚本会将权限添加到计算机标识。