Python后端开发Alexa技能：已授权仍无法获取用户邮箱的解决方法

以下是针对你遇到问题的具体排查和修复方案：

1. 确认权限配置全流程完成 #

• 开发者控制台：确保在技能的权限页面已勾选「个人资料 - 邮箱地址」，并点击保存设置。
• 用户授权：提醒用户打开Alexa应用，进入该技能的设置页面，确认邮箱地址权限已开启。仅在控制台配置权限但用户未授权的话，仍无法获取数据。

2. 修正UPS服务初始化代码 #

你当前手动实例化UpsServiceClient的方式存在问题，正确做法是通过service_client_factory直接获取UPS服务实例，这样能自动携带认证信息：

def handle(self, handler_input):
    # 正确获取UPS服务实例
    ups_service = handler_input.service_client_factory.get_ups_service()
    try:
        profile_email = ups_service.get_profile_email()
        speak_output = f"你的邮箱地址是{profile_email}"
    except Exception as e:
        logging.error(f"获取邮箱失败: {str(e)}")
        speak_output = "暂时无法获取你的邮箱地址，请稍后再试。"
    
    return (
        handler_input.response_builder
            .speak(speak_output)
            .response
    )

3. 添加权限前置检查逻辑 #

在调用邮箱获取接口前，先检查用户是否已授权，未授权时引导用户操作：

def handle(self, handler_input):
    # 检查用户是否授权
    permissions = handler_input.request_envelope.context.system.user.permissions
    if not permissions or not permissions.consent_token:
        speak_output = "请先在Alexa应用中为该技能授权邮箱访问权限。"
        return (
            handler_input.response_builder
                .speak(speak_output)
                .set_card(StandardCard(
                    title="权限授权",
                    text="打开Alexa应用，进入该技能的设置页面，开启邮箱地址权限即可使用。"
                ))
                .response
        )
    
    # 授权成功后获取邮箱
    ups_service = handler_input.service_client_factory.get_ups_service()
    try:
        profile_email = ups_service.get_profile_email()
        speak_output = f"你的邮箱地址是{profile_email}"
    except Exception as e:
        logging.error(f"获取邮箱失败: {str(e)}")
        speak_output = "暂时无法获取你的邮箱地址，请稍后再试。"
    
    return (
        handler_input.response_builder
            .speak(speak_output)
            .response
    )

注意：需要在代码顶部导入对应模块：

from ask_sdk_model.ui import StandardCard

4. 排查请求上下文与日志 #

• 在代码中添加日志打印，确认请求中是否包含有效的consentToken：

  logging.info(f"用户权限信息: {handler_input.request_envelope.context.system.user.permissions}")
  

• 如果日志中没有consentToken，说明用户未授权，需引导用户完成授权流程。

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