Flask+React接入CloudWatch Handler后部署环境出现CORS登录错误

我正在开发一个基于Python 3.10+Flask和React的项目，原本日志存储在本地文件，计划迁移至CloudWatch。修改Loguru的sink配置后本地运行正常，但部署后React端出现CORS错误无法登录，移除CloudWatch Handler则恢复正常。

控制台错误信息 #

Access to XMLHttpRequest at 'my.ip:port/login' from origin 'my.ip' has been blocked by CORS policy: Response to preflight request didn`t pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource。

相关代码 #

Loguru配置 #

from cloudwatch import cloudwatch
from loguru import logger
...
handler = cloudwatch.CloudWatchHandler( log_group = 'my_log_group', access_id='my_access_id', access_key='my_access_key')
logger.add(sink=handler, level='INFO')

Flask App配置 #

from flask import Flask
from flask_cors import CORS
...
app: Flask = create_app()
api = Api(app)

# 原始配置
cors = CORS(app, resources='*', headers='Content-Type')

# 曾尝试的配置
# cors = CORS(app, supports_credentials=True)
# app.config['CORS-HEADERS'] = 'Content-Type'

# 也曾尝试
# cors = CORS(app, resources='*', headers='Content-Type', supports_credentials=True, send_wildcard=True)
# app.config['CORS-HEADERS'] = 'Content-Type'

已尝试多种Flask-CORS配置均无效，请求协助排查问题原因。

1. CloudWatch Handler初始化阻塞请求处理
   部署环境中，CloudWatch Handler的同步初始化可能导致Flask应用启动或处理首个请求时阻塞，无法及时返回预检请求（OPTIONS）的响应头。本地环境网络延迟低未暴露问题，部署后AWS服务响应慢或网络延迟导致预检请求超时，CORS头无法正常返回。

   • 解决：将CloudWatch Handler改为异步初始化，避免阻塞请求流程：

     import threading
     def init_cloudwatch_logger():
         handler = cloudwatch.CloudWatchHandler(log_group='my_log_group', access_id='my_access_id', access_key='my_access_key')
         logger.add(sink=handler, level='INFO')
     # 应用启动后异步执行初始化
     threading.Thread(target=init_cloudwatch_logger, daemon=True).start()
     

2. CloudWatch Handler引发未捕获异常
   部署环境中，CloudWatch Handler可能因权限不足、VPC网络限制、凭证错误等抛出异常，导致请求处理中断，无法返回正确的CORS头。本地环境凭证和网络正常所以未触发问题。

   • 解决：
     • 检查部署环境的AWS凭证权限，确认是否具备CloudWatch Log Group的写入权限；
     • 给CloudWatch Handler添加异常捕获，避免影响请求处理：

       from cloudwatch import cloudwatch
       from loguru import logger
       import traceback
       
       def cloudwatch_sink(message):
           try:
               handler = cloudwatch.CloudWatchHandler(log_group='my_log_group', access_id='my_access_id', access_key='my_access_key')
               handler.emit(message)
           except Exception as e:
               # 降级记录本地日志
               logger.error(f"CloudWatch日志发送失败: {e}\n{traceback.format_exc()}")
       
       logger.add(sink=cloudwatch_sink, level='INFO')
       

3. Flask-CORS配置未覆盖Flask-RESTful Api
   若使用了Flask-RESTful的Api对象，仅给Flask App配置CORS可能无法生效，需要单独为Api实例配置。

   • 解决：

     api = Api(app)
     CORS(api)  # 同时为Api实例配置CORS规则
     

4. 部署环境反向代理干扰CORS头
   如果部署时使用了Nginx等反向代理，需确认代理配置是否正确传递Flask返回的CORS头，避免代理修改或移除相关响应头。

   • 解决：检查代理配置，确保Access-Control-Allow-Origin等头被完整传递到前端。

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