Debian服务器中mkdir()函数异常：无报错但无法创建目录

这种本地跑的好好的，一部署到Debian服务器就掉链子的情况我碰过好多次，大概率是环境差异导致的，咱们一步步排查：

1. 先揪出最常见的「权限问题」 #

Debian服务器上的Web服务进程（通常是www-data用户）很可能没有上级目录的写入权限。哪怕你确认上级文件夹存在，也要检查它的所有者和权限设置：

• 登录服务器，用命令查看上级目录的权限：ls -l ../files/
• 如果所有者不是www-data，执行命令修改：sudo chown -R www-data:www-data ../files/
• 另外，PHP的umask会影响mkdir实际创建的权限（比如默认umask 0022会把0777变成755），不过这一般不会阻止目录创建，但如果后续要上传文件，可能需要调整umask或者直接设置合适的目录权限。

2. 别让「隐藏的错误」蒙骗你 #

服务器上的PHP可能关闭了错误显示，导致即使mkdir失败，你也看不到任何提示。可以临时在代码开头加上错误输出：

error_reporting(E_ALL);
ini_set('display_errors', 1);

或者直接查看服务器的PHP错误日志（比如Apache的日志在/var/log/apache2/error.log，Nginx的在/var/log/nginx/error.log），日志里肯定会有失败的具体原因，比如「权限不足」「路径不存在」之类的。

3. 小心「相对路径」的陷阱 #

本地和服务器的脚本执行目录可能不一样！../files/object/是相对当前脚本的工作路径，服务器上的执行环境可能把这个路径解析到了错误的位置。建议换成绝对路径，比如用$_SERVER['DOCUMENT_ROOT']来拼接：

$url = $_SERVER['DOCUMENT_ROOT'] . '/files/object/' . $this->id;
if (!file_exists($url)) {
    mkdir($url, 0777, true);
}

这样不管脚本在哪里执行，路径都是准确的。

4. 检查「安全模块」的限制 #

Debian默认可能启用了AppArmor，它会限制Web进程的文件操作范围，哪怕目录权限正确，也会阻止创建。可以临时关闭AppArmor测试：

sudo systemctl stop apparmor

如果关闭后mkdir正常工作了，就需要配置AppArmor规则，允许Web进程写入目标目录。

5. 给mkdir加个「失败检测」 #

你的代码没有检查mkdir的返回值，建议加上日志记录，方便排查：

$url = "../files/object/" . $this->id;
if (!file_exists($url)) {
    $createSuccess = mkdir($url, 0777, true);
    if (!$createSuccess) {
        error_log("Failed to create directory: " . $url);
        // 也可以在这里抛出异常或者给用户提示
    }
}

优先排查绝对路径和权限问题，这两个是90%以上这类问题的根源，再结合错误日志，很快就能找到问题啦！

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