DigitalOcean App Platform部署Python Flask应用无法生成日志

1. 先验证目录写入权限 #

App Platform默认运行进程的用户是apps，先打开控制台的Web Shell执行以下命令，确认日志目录的可用性：

# 查看目录归属和权限
ls -ld /workspace/logs
# 测试当前用户是否有写入权限
touch /workspace/logs/test.log

如果touch命令报Permission denied错误，不要直接在运行实例里执行chmod修改——实例重建后权限会重置，你需要把目录创建、授权的逻辑写到App Platform的组件运行命令里，比如把运行命令改成：

mkdir -p /workspace/logs && chown apps:apps /workspace/logs && gunicorn app:app

2. 修正日志配置的常见代码错误 #

绝大多数改了绝对路径还是不生效的问题，都是代码配置的疏漏，重点检查两个点：

• 不要把目录路径直接传给日志FileHandler：你配置的LOG_LOCATION = '/workspace/logs'是目录，必须拼接具体的日志文件名，否则handler会尝试把目录当文件打开，直接静默失败。
• 不要依赖提前创建好的日志目录：部署时目录可能不存在，要在日志初始化逻辑里加自动建目录的代码，参考配置如下：

import os
import logging
from logging.handlers import RotatingFileHandler

# 日志初始化逻辑
log_dir = app.config["LOG_LOCATION"]
# 递归创建日志目录，已存在时不报错
os.makedirs(log_dir, exist_ok=True)
# 拼接完整日志文件路径
log_path = os.path.join(log_dir, "app.log")

# 初始化文件日志handler
file_handler = RotatingFileHandler(
    log_path,
    maxBytes=10 * 1024 * 1024, # 单日志文件最大10M
    backupCount=5, # 最多保留5个备份
    encoding="utf-8"
)
file_handler.setFormatter(logging.Formatter(
    "%(asctime)s %(levelname)s: %(message)s [in %(pathname)s:%(lineno)d]"
))
file_handler.setLevel(logging.INFO)
app.logger.addHandler(file_handler)
app.logger.setLevel(logging.INFO)

3. 注意平台文件系统的特性 #

App Platform默认使用临时文件系统，除了手动挂载的持久卷，所有目录的内容都会在实例重启、重新部署时被清空，甚至部分运行时环境会限制非标准目录的写入权限。
如果不需要长期留存历史日志，强烈推荐直接把日志输出到标准输出流（stdout/stderr），这也是平台官方推荐的日志方案：平台会自动收集所有控制台输出，你可以直接在控制台的「Logs」标签页查看实时和历史日志，也可以配置转发到第三方日志服务，不需要自己维护本地日志文件。配置方式非常简单，加一个流日志处理器即可：

stream_handler = logging.StreamHandler()
stream_handler.setLevel(logging.INFO)
app.logger.addHandler(stream_handler)

如果确实需要持久化存储本地日志文件，需要在App Platform组件设置里挂载持久卷（Persistent Volume），把日志路径配置为持久卷的挂载路径即可。

4. 定位静默报错 #

如果以上步骤都配置完成还是不生成日志，可以临时开启logging模块的异常抛出，定位具体错误：

import logging
logging.raiseExceptions = True

部署后触发一次日志写入，控制台会直接输出日志模块的具体报错，比如路径非法、权限不足等，根据报错调整即可。

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