WSO2 AM 4.1.0自定义Vhost配置后部署阶段不可见问题求助

以下是针对性的排查与解决步骤：

1. 严格校验deployment.toml配置格式 #

确保自定义vhost配置放置在正确的区块下，且语法符合TOML规范，示例正确配置如下：

[apim.gateway.custom_vhosts]
custom_vhost1 = {hostname = "api.example.com", display_name = "Example API Host"}

• 检查是否存在引号遗漏、逗号错位、多余空格等语法错误，TOML对格式要求严格，微小错误会导致配置不生效。

2. 确认配置同步与服务重启 #

• 若为分布式部署（Publisher、Store、网关节点分离），需将Publisher节点的deployment.toml配置同步到所有网关节点。
• 修改配置后，必须重启Publisher服务和所有网关节点，配置变更需重启才能加载生效。

3. 规范API发布流程 #

• 在Publisher的API部署页面，确认已选择目标网关环境，未选择正确环境会导致vhost配置无法关联到API。
• 若API已发布过，尝试重新发布API，避免旧缓存覆盖新配置。
• 查看网关日志（<APIM_HOME>/repository/logs/gateway.log），搜索vhost相关关键词，排查是否有加载错误或异常信息。

4. 验证主机名与SSL配置（若需HTTPS） #

• 确保自定义vhost的主机名在部署环境中可正常解析（通过本地hosts文件或DNS配置）。
• 若启用HTTPS，需补充SSL证书配置，示例：

[apim.gateway.custom_vhosts.custom_vhost1]
hostname = "api.example.com"
display_name = "Example API Host"
ssl.enabled = true
ssl.certificate.file = "${carbon.home}/repository/resources/security/api_example_com.pem"
ssl.certificate.key.file = "${carbon.home}/repository/resources/security/api_example_com.key"
ssl.certificate.key.password = "your-cert-password"

5. 清理缓存与刷新元数据 #

• 登录Publisher后台，进入目标API的「Settings」页面，点击「Reload Metadata」按钮刷新API元数据。
• 清理网关节点的缓存目录：<APIM_HOME>/repository/tmp 和 <APIM_HOME>/repository/carbonapps，清理完成后重启网关。

6. 检查数据库配置同步 #

• 查看APIM关联的数据库（如MySQL、PostgreSQL）中AM_GATEWAY_ENVIRONMENT表，确认是否存在自定义vhost的配置记录。
• 若记录缺失，可手动插入匹配环境ID的vhost配置，或重新触发配置同步。

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