为WSO2开发者门户配置AI推荐后功能未生效的问题

已按照官方指引在deployment.toml中添加AI推荐功能配置，重启服务器后功能仍未生效，配置内容如下：

[apim.devportal.recommendations]
recommendations_api = "a5753b42-9dac-44c1-8f01-45688c1bf129"
consumer_key = "c7xp1kfRcp5VCdrNyvy3obZcA6ga"
consumer_secret = "8PQjEZq2uHezRIm7SwVnUfBAvNwa"
max_recommendations = 10
wait_duration = 10
apply_for_all_tenants = false

可通过以下步骤排查问题：

• 验证配置文件路径与生效范围
  确认deployment.toml文件位于WSO2 APIM的<APIM_HOME>/repository/conf目录下；若为多租户环境且apply_for_all_tenants设为false，需检查当前租户是否存在覆盖全局配置的租户级设置，避免全局配置被忽略。

• 检查配置参数有效性

  • recommendations_api：确认该UUID对应的API已在APIM中正确发布且状态为已部署，同时开发者门户的访问用户具备调用该API的权限。
  • consumer_key与consumer_secret：验证这对密钥所属的OAuth应用已生效，且该应用被授权调用上述推荐API，可通过管理控制台的应用列表查看密钥状态与权限范围。
  • max_recommendations与wait_duration：确保参数为合法整数，无格式错误（如多余空格、非数字字符）。

• 查看服务器日志定位错误
  重启服务器后，检查<APIM_HOME>/repository/logs/wso2carbon.log和<APIM_HOME>/repository/logs/devportal.log，搜索recommendations或devportal关键词，排查配置加载失败、API调用异常、权限不足等报错信息，比如OAuth令牌获取失败、推荐API返回错误码等。

• 清除开发者门户缓存
  若此前未启用该功能，可能存在缓存残留。删除<APIM_HOME>/repository/deployment/server/jaggeryapps/devportal/target目录下的缓存文件，重启服务器后重新测试。

• 确认依赖组件运行状态
  AI推荐功能依赖APIM的网关与身份验证服务，需确保网关节点正常运行，OAuth令牌获取接口（/oauth2/token）能正常返回有效令牌，可通过管理控制台检查网关状态或直接调用接口验证。

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