使用flask-ask开发Alexa技能时LaunchRequest返回400错误排查求助

我之前开发Alexa技能时也碰到过几乎一模一样的400错误，结合你的描述，给你几个针对性的排查和解决方向：

1. 确认Endpoint路径配置完全匹配 #

flask-ask会把所有Alexa请求路由到你初始化时指定的路径（比如ask = Ask(app, '/alexa')），如果Alexa控制台里的Endpoint地址没加上这个路径，请求就会落到flask的默认无处理逻辑的路由上，直接返回400。

• 本地用ngrok时，要确保Endpoint是https://<ngrok-id>.ngrok.io/你的flask-ask路径
• zappa部署后，Endpoint是zappa生成的API Gateway地址，同样要补上正确的路径后缀

2. 关闭本地调试时的签名验证 #

flask-ask默认会校验Alexa请求的签名，但本地ngrok的临时HTTPS证书过不了Alexa的签名校验，这会直接拒绝请求返回400。你可以在初始化Ask对象时临时关闭验证：

from flask import Flask
from flask_ask import Ask

app = Flask(__name__)
# 仅本地调试时加verify=False，部署后建议开启验证
ask = Ask(app, '/alexa', verify=False)

3. 打印请求日志，排查格式问题 #

本地调试时，添加一个请求日志钩子，查看Alexa发送的原始请求内容，确认是否符合flask-ask的解析要求：

@app.before_request
def log_request_details():
    app.logger.info(f"请求方法: {request.method}")
    app.logger.info(f"请求内容: {request.data.decode('utf-8')}")

如果请求格式不符合Alexa的规范（比如缺少必要字段），flask-ask会直接返回400，通过日志能快速定位问题。

4. 处理Alexa的Endpoint验证请求 #

Alexa控制台配置Endpoint后，会发送一个带hub.challenge参数的GET请求做验证，如果你的flask应用没处理这个GET请求，会返回400，导致后续的LaunchRequest也无法正常触发。添加一个GET路由处理验证：

@app.route('/alexa', methods=['GET'])
def alexa_verify():
    return request.args.get('hub.challenge')

搞定这个验证后，后续的POST请求（LaunchRequest）才能被正确接收。

5. 检查flask-ask版本兼容性 #

旧版本的flask-ask可能不兼容最新的Alexa请求格式，建议升级到最新版本：

pip install --upgrade flask-ask

关于zappa部署后只看到第二个请求的问题：第一个请求大概率是Alexa的Endpoint验证GET请求，zappa的日志可能过滤了GET请求或者Lambda冷启动导致日志未被捕获，解决上述验证请求的处理后，应该能看到完整的请求日志。

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