“权限不足”提示但文件上传成功，实为临时文件读取失败，需检查open_basedir、upload_tmp_dir权限及SELinux/AppArmor限制，并验证MySQL INSERT权限与CSV编码、换行符兼容性。
导入时提示“权限不足”但文件已上传成功
这通常不是 PHP 文件读取权限问题，而是 fopen() 或 fgetcsv() 尝试读取临时上传文件（如 $_FILES['file']['tmp_name']）失败所致。PHP 默认允许读取临时文件，但如果 Web 服务器（如 Nginx + PHP-FPM）以不同用户运行，或启用了 open_basedir 限制，就会报“权限不足”而非更明确的错误。
- 先用
is_readable($_FILES['file']['tmp_name'])检查是否可读，避免直接传给fgetcsv() - 若返回
false，检查php.ini中open_basedir是否包含系统临时目录（如/tmp），或将其设为空（open_basedir = ""）临时验证 - 确认
upload_tmp_dir指向的路径存在且 Web 进程用户（如www-data或nginx）有读写权限，而非仅 root
使用 move_uploaded_file() 后仍无法解析 CSV
手动把上传文件移到项目目录再读取，看似绕过权限，实则可能引入新问题：CSV 编码（尤其是 GBK/GB2312）、BOM 头、换行符不一致，都会让 fgetcsv() 提前终止或漏行。
- 移动后务必用
file_get_contents()读原始字节，检查前 3 字节是否为\xEF\xBB\xBF（UTF-8 BOM），有则需截掉 - 用
mb_detect_encoding($content, ['UTF-8', 'GBK', 'BIG5'], true)判断真实编码，再用mb_convert_encoding()统一转 UTF-8 -
fgetcsv()默认按"\n"分割，但 Windows 上传的 CSV 常含"\r\n"，建议显式传入第三个参数：fgetcsv($fp, 0, ',', '"', '"')，并确保文件指针位置正确
数据库写入阶段报“INSERT 权限被拒绝”
前端导入成功、解析无误，但最终存不进数据库——这和文件系统权限无关，是 MySQL 用户缺少 INSERT 或 UPDATE 权限。尤其当班级通信录需批量插入多条记录，或先清空再导入时，TRUNCATE 或 DELETE 权限也可能缺失。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
- 登录 MySQL，执行
SHOW GRANTS FOR 'your_php_user'@'%';，确认包含类似GRANT INSERT, UPDATE ON `school_db`.`contact_list` TO ... - 若用的是通配符库名（如
`school_%`），注意导入表名是否匹配；生产环境不建议直接授ALL PRIVILEGES - 批量插入时，用
INSERT INTO ... VALUES (...), (...), (...)单语句代替循环INSERT，既提升性能，也减少权限校验次数
Linux 下 SELinux 或 AppArmor 干预导致失败
在 CentOS/RHEL（启用 SELinux）或 Ubuntu（启用 AppArmor）上，即使文件权限、PHP 配置、MySQL 权限全对，仍可能静默失败。Web 进程被安全模块限制访问临时目录或数据库 socket。
立即学习“PHP免费学习笔记（深入）”；
- 临时排查：执行
setenforce 0（SELinux）或aa-disable /usr/sbin/php-fpm（AppArmor），看是否恢复；切勿长期关闭 - SELinux 下，给上传目录打标：
chcon -t httpd_upload_t /var/tmp（对应upload_tmp_dir路径） - AppArmor 下，编辑
/etc/apparmor.d/usr.sbin.php-fpm，添加/var/tmp/** rw,并重载策略：sudo systemctl reload apparmor
实际部署时，最易被忽略的是 SELinux/AppArmor 和 MySQL 权限粒度——它们不会抛出“Permission denied”字符串，而表现为超时、空数组或连接中断。调试优先查日志：/var/log/audit/audit.log（SELinux）、/var/log/mysql/error.log、以及 PHP 的 error_log。
