Codeigniter 3部署Nginx服务器后上传目录不可写入问题求助

本地运行正常的CodeIgniter 3项目，部署到Nginx服务器后出现错误：The upload destination folder does not appear to be writable，即使已将assets文件夹权限设置为777，可按以下步骤排查解决：

1. 检查目录所有者与用户组 #

Nginx通常以www-data（Debian/Ubuntu系）或nginx（CentOS/RHEL系）用户运行，需确保上传目录的所有者与Nginx进程一致，否则即使权限为777，进程也无法写入。执行对应系统的命令：

# Debian/Ubuntu系统
chown -R www-data:www-data /path/to/your/project/assets/images
# CentOS/RHEL系统
chown -R nginx:nginx /path/to/your/project/assets/images

2. 使用绝对路径替换相对路径 #

CodeIgniter的相对路径可能因Nginx的root配置差异导致解析错误，建议改用框架提供的FCPATH常量（指向项目根目录）来定义上传路径：
修改控制器中的上传配置：

$config['upload_path'] = FCPATH . 'assets/images/';

3. 检查SELinux限制（仅CentOS/RHEL等系统） #

CentOS等系统默认开启SELinux，即使权限和所有者正确，SELinux也可能阻止Nginx写入目录。可临时关闭测试：

setenforce 0

若测试后恢复正常，需设置永久SELinux规则允许HTTP服务读写该目录：

chcon -R -t httpd_sys_rw_content_t /path/to/your/project/assets/images

4. 验证Nginx配置正确性 #

确保Nginx配置中项目的root指向正确目录，且PHP解析规则无误。示例配置：

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/your/project;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 适配你的PHP版本
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

修改配置后重启Nginx：

systemctl restart nginx

调试建议 #

可在控制器中添加以下代码，确认上传路径的正确性及可写状态：

echo "实际上传路径: " . $config['upload_path'];
echo "<br>是否可写: " . (is_writable($config['upload_path']) ? '是' : '否');
exit;

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