AWS API Gateway：解决 SAM 本地调用期间 OPTIONS 请求的 403 错误

修复本地 SAM 调用的 AWS API Gateway 上的 403 错误。

解决方案 1：使用 Express.js 和 AWS SDK 的 Node.js 后端，具有高效的 CORS 和 OPTIONS 处理。

// Import required modules
const express = require('express');
const AWS = require('aws-sdk');
const cors = require('cors');
const app = express();
app.use(cors());
// Middleware for JSON request parsing
app.use(express.json());
// CORS preflight response handling
app.options('/scanRecords', (req, res) => {
  res.setHeader('Access-Control-Allow-Origin', '*');
  res.setHeader('Access-Control-Allow-Methods', 'POST, OPTIONS');
  res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
  res.status(200).send();
});
// Main POST method for scanRecords
app.post('/scanRecords', async (req, res) => {
  const dynamoDB = new AWS.DynamoDB.DocumentClient();
  try {
    const params = { TableName: 'RecordsTable' };
    const data = await dynamoDB.scan(params).promise();
    res.status(200).json(data);
  } catch (err) {
    res.status(500).send('Error fetching records');
  }
});
// Start the Express server on PORT 3000
app.listen(3000, () => {
  console.log('Server running on http://localhost:3000');
});

解决 AWS SAM Local 中的“缺少身份验证令牌”

解决方案 2：使用 Flask 的 Python 后端，配置本地 SAM 和 API 网关

from flask import Flask, jsonify, request
import boto3
app = Flask(__name__)
# CORS headers for OPTIONS requests
@app.route('/scanRecords', methods=['OPTIONS'])
def options_method():
    response = app.response_class(status=200)
    response.headers['Access-Control-Allow-Origin'] = '*'
    response.headers['Access-Control-Allow-Methods'] = 'POST, OPTIONS'
    response.headers['Access-Control-Allow-Headers'] = 'Content-Type, Authorization'
    return response
# POST method to scan records from DynamoDB
@app.route('/scanRecords', methods=['POST'])
def scan_records():
    dynamodb = boto3.resource('dynamodb')
    table = dynamodb.Table('RecordsTable')
    try:
        response = table.scan()
        return jsonify(response['Items']), 200
    except Exception as e:
        return str(e), 500
# Run the Flask app on port 3000
if __name__ == '__main__':
    app.run(debug=True, host='0.0.0.0', port=3000)

使用 SAM 测试 AWS API Gateway 本地调用

解决方案 3：配置 SAM 模板来处理 OPTIONS 请求并避免 403 错误。

Resources:
  scanRecords:
    Type: AWS::Serverless::Function
    Properties:
      Handler: dist/dynamo/CRUD.scanRecords
      CodeUri: ./backend
      Policies:
        - AmazonDynamoDBFullAccess
        - CloudWatchLogsFullAccess
      Events:
        ApiEvent:
          Type: Api
          Properties:
            Path: /scanRecords
            Method: post
  scanRecordsOptionsMethod:
    Type: AWS::ApiGateway::Method
    Properties:
      AuthorizationType: NONE
      HttpMethod: OPTIONS
      ResourceId: !Ref scanRecordsResource
      RestApiId: !Ref apiGatewayRestApi
      Integration:
        Type: MOCK
        IntegrationResponses:
          - StatusCode: 200
            ResponseParameters:
              method.response.header.Access-Control-Allow-Headers: "'Content-Type,X-Amz-Date,Authorization,X-Api-Key,X-Amz-Security-Token'"
              method.response.header.Access-Control-Allow-Methods: "'POST,OPTIONS'"
              method.response.header.Access-Control-Allow-Origin: "'*'"

有关 AWS API Gateway 403 错误的常见问题

1. 为什么我仅在 SAM 本地中收到 403 问题，但在部署时却没有收到 403 问题？
2. 本地 SAM 环境可能无法模仿完整的 API 网关配置，特别是对于 AuthorizationType 和 CORS 设置。确保您的本地设置与部署的设置匹配，包括 OPTIONS 请求的虚假集成。
3. 什么是“缺少身份验证令牌”错误？
4. 此错误表明 API 网关需要身份验证令牌，但未提供该令牌。对于 OPTIONS 请求，请确保 AuthorizationType: NONE 已在您的 SAM 模板中正确配置。
5. 如何在 AWS API Gateway 中处理 CORS 预检请求？
6. 要处理 CORS，请确保您的 OPTIONS 方法适当地设置了相关的响应头，例如 Access-Control-Allow-Origin 和 Access-Control-Allow-Methods。
7. 我可以使用 AWS SAM 在本地测试 CORS 吗？
8. 是的，您可以在本地测试 CORS，但请确保您的 app.options() 方法或等效的 API 网关配置返回预检 OPTIONS 请求的正确标头。
9. 什么是 AWS API Gateway 中的模拟集成？
10. 一个 MOCK integration 使您能够从 API Gateway 返回静态响应，而无需使用后端 Lambda 函数，从而简化了 OPTIONS 请求的 CORS 处理。

关于修复 AWS API Gateway 403 错误的最终想法

要修复本地 SAM 环境中 OPTIONS 请求的 403 错误，请确保您的 SAM 模板 并且权限配置正确。让您的本地环境尽可能与您部署的 AWS 配置相匹配至关重要。

为了防止丢失令牌问题，请将 AuthorizationType 更改为“NONE”并使用假集成进行预检 CORS 查询。解决这些设置问题可以实现顺利的本地开发和正确的 API 网关行为。