Django服务器启动后计算文件夹大小函数仅生效一次的问题求助

看起来你遇到的问题是这个计算文件夹大小的函数在Django服务器启动后只正确运行一次，之后每次都返回0 MB对吧？我来帮你梳理下可能的原因和对应的解决办法：

可能的原因及排查步骤 #

1. 路径传递错误或路径无效 #

这是最常见的原因——后续调用函数时传递的folder_path可能是空、拼写错误，或者是相对路径导致运行时工作目录变化后路径失效。

排查&修复：

• 在函数开头添加更详细的日志，确认每次调用时的路径和当前工作目录：

  def size_folder(folder_path):
      # 打印绝对路径和当前工作目录，方便排查
      print(f"Target folder absolute path: {os.path.abspath(folder_path)}")
      print(f"Current working directory: {os.getcwd()}")
      
      # 先校验路径是否有效
      if not os.path.isdir(folder_path):
          print(f"Warning: {folder_path} is not a valid existing directory")
          return "0 MB"
      # 剩余逻辑...
  

• 检查调用这个函数的代码，确认folder_path是动态生成的正确绝对路径，而不是硬编码的相对路径（比如服务器启动时的相对路径，后续任务执行时工作目录变了就会失效）。

2. 权限问题 #

第一次运行时进程有文件夹的读取权限，但后续任务（比如用Celery执行异步任务）的运行用户没有访问权限，导致无法读取文件大小，最终返回0。

排查&修复：

• 在函数中添加权限校验，同时跳过无权限的文件：

  def size_folder(folder_path):
      if not os.path.isdir(folder_path):
          print(f"Error: {folder_path} is not a valid directory")
          return "0 MB"
      if not os.access(folder_path, os.R_OK):
          print(f"Error: No read permission for {folder_path}")
          return "0 MB"
      
      folder_size = 0
      for (path, dirs, files) in os.walk(folder_path):
          for file in files:
              filename = os.path.join(path, file)
              # 校验文件是否可读，避免权限问题导致报错
              if os.access(filename, os.R_OK):
                  folder_size += os.path.getsize(filename)
              else:
                  print(f"Skipping unreadable file: {filename}")
      # 大小转换逻辑...
      folder_size = folder_size / (1024* 1024.0)
      folder_size = round(folder_size, 5) if folder_size < 1 else round(folder_size, 2)
      return f"{folder_size} MB"
  

• 如果用了异步任务框架（如Celery），确认执行任务的用户和Django服务器用户拥有相同的文件夹访问权限。

3. 缓存导致结果被固定 #

如果这个函数被缓存装饰器（比如Django的@cached_property、@cache_page，或者第三方缓存工具）修饰，会导致首次计算的结果被缓存，后续调用直接返回缓存值（如果首次之后文件夹被清空过，缓存的就是0）。

排查&修复：

• 检查调用size_folder的代码位置，比如模型方法：

  # 错误示例：使用cached_property会缓存结果
  class TaskModel(models.Model):
      @cached_property
      def folder_size(self):
          return size_folder(self.task_folder_path)
  
  # 正确做法：改成普通方法，每次调用重新计算
  class TaskModel(models.Model):
      def get_folder_size(self):
          return size_folder(self.task_folder_path)
  

• 如果确实需要缓存，确保在任务执行完成后主动清除对应缓存，再重新计算。

4. os.walk跳过了目录 #

默认情况下os.walk不会跟随符号链接，如果你的文件夹包含符号链接指向的文件，会导致部分文件被忽略。如果需要处理符号链接，可以添加followlinks=True参数（注意避免循环引用）：

for (path, dirs, files) in os.walk(folder_path, followlinks=True):

测试建议 #

你可以先在Django Shell中手动多次调用size_folder函数，传递同一个有效文件夹路径，看看返回结果是否一致：

python manage.py shell

from your_app.utils import size_folder
print(size_folder("/path/to/your/test/folder"))
# 重复调用几次，看结果是否正确
print(size_folder("/path/to/your/test/folder"))

如果Shell中调用正常，那问题大概率出在Django请求/任务的上下文里，比如路径传递或者权限问题。

内容的提问来源于stack exchange，提问作者Kévin