Azure部署后Flask应用摘要文件生成存储异常排查请求

核心问题定位 #

本地运行正常但Azure部署后管理员无法读取摘要，排除路径问题后，重点排查以下方向：

1. Azure App Service文件系统的特殊性 #

Azure App Service的默认本地存储是临时存储，重启实例后数据会丢失，且部分目录存在写入权限限制。如果summary文件夹创建在应用根目录，大概率会出现文件丢失或无法写入的情况。

• 解决：配置持久化存储，通过Azure存储账户的文件共享挂载到App Service，将摘要文件写入持久化目录。代码示例：

  import os
  # 获取App Service持久存储根路径，不存在则 fallback 到本地目录
  content_root = os.environ.get('WEBSITE_CONTENT_ROOT', os.path.abspath(os.path.dirname(__file__)))
  summary_dir = os.path.join(content_root, 'summary')
  os.makedirs(summary_dir, exist_ok=True)
  

2. 摘要生成逻辑的异常遗漏 #

本地运行时忽略的异常（如文件编码、依赖版本差异）在Azure环境中触发，导致文件未生成。

• 解决：在摘要生成代码中添加完整的异常捕获与日志输出：

  from flask import current_app
  try:
      # 替换为你的摘要生成逻辑
      with open(os.path.join(summary_dir, f"{user_id}_summary.txt"), 'w', encoding='utf-8') as f:
          f.write(generated_summary)
  except Exception as e:
      current_app.logger.error(f"摘要生成失败: {str(e)}")
  

• 查看Azure日志：在App Service门户的「日志流」中查看实时错误信息，定位具体异常。

3. 读写路径的一致性问题 #

即使修改了绝对路径，要确保写入和读取使用完全相同的路径变量，避免因环境变量差异导致路径不匹配。

• 解决：全局统一路径变量，比如：

  # 全局定义路径
  BASE_DIR = os.path.abspath(os.path.dirname(__file__))
  SUMMARY_DIR = os.path.join(BASE_DIR, 'summary')
  # 写入和读取都使用SUMMARY_DIR变量
  

4. 部署过程的目录覆盖问题 #

如果使用Zip部署或自动部署，summary文件夹可能被部署包覆盖，或者部署时未自动创建该目录。

• 解决：
  1. 在应用启动时自动创建summary目录（已包含在上述代码中）
  2. 创建.deployment文件，添加配置排除summary目录被部署覆盖：

     [config]
     EXCLUDE_FROM_DEPLOYMENT = summary/
     

快速验证步骤 #

1. 进入Azure App Service的「高级工具」>「Kudu」，打开CMD终端，检查summary目录是否存在、是否有生成的文件
2. 手动上传一个测试摘要文件到summary目录，测试管理员端是否能读取，排除读取逻辑本身的问题
3. 查看应用日志，确认摘要生成过程中是否有报错信息

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