根本原因是AddHandler规则未作用于虚拟目录上下文；需检查AllowOverride设置、手动添加AddHandler、确认模块启用、路径权限及SCRIPT_FILENAME拼接是否正确，并排除缓存干扰。
Apache 虚拟目录下 PHP 文件不解析、直接下载或返回空白，根本原因是 AddHandler 规则未作用于该虚拟目录上下文，而非 PHP 模块没装好。必须让 Apache 明确知道：这个目录里的 .php 文件，要交给 PHP 模块执行。
确认虚拟目录是否继承了 PHP 处理规则
Apache 的 AddHandler application/x-httpd-php .php 默认只写在全局模块配置（如 /etc/apache2/mods-available/php8.0.conf）里，但虚拟主机（<VirtualHost>）或 <Directory> 块若设置了 AllowOverride None 或显式清空了 Handlers，就会屏蔽该规则。
- 检查你的虚拟目录配置中是否有
AllowOverride None—— 若有，改成AllowOverride All或至少AllowOverride FileInfo（允许AddHandler生效） - 在虚拟目录的
<Directory "/path/to/vhost">块内，**手动补上**：AddHandler application/x-httpd-php .php
- 确保该目录下没有
.htaccess文件意外覆盖了 handler 设置（可临时重命名测试）
验证 PHP 模块是否对当前上下文生效
模块加载（a2enmod php8.0）只是第一步；Apache 还要确认该虚拟主机/目录允许调用 PHP 模块。常见断点：
- 运行
apache2ctl -t -D DUMP_MODULES | grep php，确认php8_module在输出中 —— 若无，说明模块未启用或被a2disconf关闭过 - 检查虚拟主机配置中是否含
SetHandler application/x-httpd-php（错误写法），它会强制接管所有请求，包括图片/CSS，应避免 - 若用了
php8.0-fpm，则不能依赖AddHandler，而需在虚拟目录内配ProxyPassMatch或FPM相关SetHandler，且确保proxy_fcgi模块已启用
检查文件路径与 DocumentRoot 是否错位
虚拟目录常通过 Alias 或 AliasMatch 指向非 DocumentRoot 下的路径，此时 $document_root 变量失效，导致 SCRIPT_FILENAME 无法拼出正确路径，PHP 收不到脚本内容，直接返回空白或 404。
立即学习“PHP免费学习笔记（深入）”；
- 在虚拟目录配置中，**必须显式设置**：
ScriptAlias /php-bin/ "/usr/lib/cgi-bin/"
（仅当用 CGI 模式）
或更常见的是，在<Directory>内加：Options +ExecCGI<br>Require all granted
- 若用模块模式（推荐），确保
Directory块中包含：Require all granted<br>FallbackResource /index.php
（防路由丢失） - 用
curl -I http://yoursite/vdir/test.php查响应头：若看到Content-Type: text/plain，说明 Apache 当它纯文本；若为application/x-httpd-php，说明 handler 生效但 PHP 执行失败
绕过缓存快速验证真实行为
浏览器和 Apache 都可能缓存 404 或空响应，掩盖真实问题。每次修改后务必：
- 重启 Apache：
sudo systemctl restart apache2（不要只 reload） - 清空浏览器缓存，或用
curl -v http://localhost/vdir/test.php直接看原始响应 - 新建最小测试文件：
echo '<?php echo "OK"; ?>' | sudo tee /var/www/vdir/test.php，避免 BOM 或语法干扰 - 检查 Apache 错误日志：
sudo tail -f /var/log/apache2/error.log，搜索Primary script unknown或Permission denied
最易忽略的一点：虚拟目录路径若含空格或中文，Apache 默认拒绝处理，且不报明确错误 —— 改用纯英文、无空格路径再试。
