Django中Path.home()指向服务器目录而非用户目录的权限问题

问题根源 #

本地开发时，Path.home()指向你本地用户的主目录（如C:\Users\你的用户名\Downloads或/home/你的用户名/Downloads），有足够写入权限。但生产环境中，Django通常以服务器用户（比如www-data）运行，该用户主目录为/var/www，目录下默认无Downloads文件夹，且www-data对/var/www大概率无写入权限，因此触发PermissionError。

解决方案 #

1. 配置项目专属下载目录 #

在Django项目的settings.py中添加自定义下载目录配置，指向服务器上可写入的路径：

# settings.py
import os
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

# 自定义下载目录，建议放在项目目录内或专门的媒体存储区
DOWNLOAD_DIR = os.path.join(BASE_DIR, 'downloads')

2. 创建目录并设置正确权限 #

在服务器上创建目录，将所有权赋予Django运行用户（以www-data为例）：

# 创建下载目录
mkdir /var/www/your_project_name/downloads

# 设置目录所有权
sudo chown -R www-data:www-data /var/www/your_project_name/downloads

# 设置目录权限（确保运行用户有读写执行权限）
sudo chmod -R 755 /var/www/your_project_name/downloads

3. 修改下载代码 #

替换原代码中依赖Path.home()的部分，改用配置的DOWNLOAD_DIR：

from django.conf import settings
import os

# 获取项目配置的下载目录
downloads_path = settings.DOWNLOAD_DIR

# 创建客户专属子目录
customer_dir = os.path.join(downloads_path, str(row['CUSTOMER NAME']))
if not os.path.isdir(customer_dir):
    os.makedirs(customer_dir, exist_ok=True)  # 避免重复创建的异常

# 保存PDF文件
pdf_output_path = os.path.join(customer_dir, 'document.pdf')
pdf.output(pdf_output_path)

额外说明 #

• 避免直接操作服务器系统级目录（如/var/www），优先使用项目内部目录或专门的媒体存储目录，便于权限管理和维护。
• 如果需要让用户下载这些文件，生产环境建议用Nginx等静态文件服务器代理媒体请求，不要让Django直接处理。

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