与404（页面未找到）不同，500错误通常是服务器端的配置或代码问题，好消息是，通过系统性的排查,绝大多数问题都可以解决。
（图片来源网络，侵删）
下面我将为你提供一个从易到难、从常见到罕见的完整排查指南。
核心排查思路：
- 让服务器“开口说话”：500错误默认不显示具体原因,我们需要先让PHP把错误信息显示出来。
- 检查配置：IIS、PHP、FastCGI之间的配置是否正确。
- 检查代码：PHP脚本本身是否有语法错误或逻辑问题。
- 检查权限：IIS进程是否有权限访问必要的文件和目录。
第一步：开启PHP错误显示（最重要的一步）
这是解决PHP问题的第一步，也是最重要的一步，如果错误信息不显示,你将像盲人摸象一样乱猜。
-
编辑
php.ini文件：- 这个文件的位置可能因你的安装方式而异，你可以在
C:\php、C:\Program Files\PHP等目录下找到它。 - 如果你不确定它的位置，可以在IIS管理器中：
- 选择你的网站。
- 双击 "处理程序映射" (Handler Mappings)。
- 找到
PHP_via_FastCGI或类似的条目,双击它。 - 在弹出的窗口中，点击“请求限制...” (Request Limits...)。
- 在“脚本”选项卡下，找到“可执行文件”路径，这个路径通常指向
php-cgi.exe所在的目录，而php.ini文件通常就在这个目录里。
- 这个文件的位置可能因你的安装方式而异，你可以在
-
修改以下配置项：
（图片来源网络，侵删）display_errors = On：确保这个值是On,这样错误信息才会显示在网页上。error_reporting = E_ALL：设置报告所有级别的错误。log_errors = On：同时开启错误日志记录,这是一个好习惯。error_log = C:\php\logs\php_error.log：指定一个错误日志文件的路径，确保这个目录存在,并且IIS用户有写入权限。
-
重启IIS和PHP FastCGI服务：
- 修改
php.ini后必须重启服务才能生效。 - 重启IIS：打开命令提示符（管理员身份），运行
iisreset /restart。 - 重启PHP FastCGI：在服务中找到 "FastCGI Process Pool" 相关的服务，重启它，或者，在IIS管理器中，点击 "FastCGI 设置"，右键点击你的PHP进程池，选择“回收”或“停止”再“启动”。
- 修改
刷新你的出错的PHP页面，你应该能看到具体的错误信息了，"Fatal error: Uncaught Error: Call to undefined function ..." 或 "Parse error: syntax error ..."，根据这个信息,你就可以直接定位到代码问题了。
第二步：检查IIS与PHP的配置
如果开启错误显示后页面仍然是空白或500错误,那很可能是配置问题。
-
处理程序映射：
- 在IIS管理器中，确保你的网站有正确的处理程序映射来处理
.php文件。 - 进入你的网站 -> "处理程序映射"。
- 你应该能看到一个名为
PHP_via_FastCGI(或类似名称) 的映射，请求路径为*.php。 - 如果没有，你需要手动添加：
- 点击“添加模块映射...”。
- 请求路径：
*.php - 模块：
FastCgiModule - 可执行文件：指向你的
php-cgi.exe的完整路径，C:\php\php-cgi.exe。 - 名称：可以填写
PHP_via_FastCGI。
- 在IIS管理器中，确保你的网站有正确的处理程序映射来处理
-
FastCGI设置：
- 在IIS管理器左侧，点击服务器节点 -> "FastCGI 设置"。
- 在右侧列表中，你应该能看到一个条目，其可执行文件路径同样指向
php-cgi.exe。 - 双击这个条目，检查以下关键设置：
- 环境变量：
- 确保
PHP_INI_SCAN_DIR存在且指向包含php.ini的目录,或者设置为空让它在默认位置查找。 - 非常重要：添加一个环境变量
PHPRC，其值为你的php.ini文件所在的目录（C:\php）,这可以确保IIS总能找到正确的配置文件。
- 确保
- 活动超时：可以适当调大一些，
300秒,以防脚本执行时间过长导致超时。 - 实例最大数：根据你的服务器性能和并发量设置，默认值
-1（无限制）通常可以。
- 环境变量：
-
默认文档：
- 进入你的网站 -> "默认文档"。
- 确保
index.php在列表中，并且顺序合理（比如在index.html之前）。
第三步：检查PHP脚本本身
-
语法错误：
- 这是最常见的原因，一个缺失的分号、一个括号不匹配、一个拼写错误的函数名等,都可能导致500错误。
- 解决方法：使用一个代码编辑器（如 VS Code, Sublime Text, Notepad++）打开你的PHP文件，编辑器通常会高亮显示语法错误，或者，将代码复制到 Online PHP Validator 等在线工具中进行检查。
-
内存不足或执行超时：
- 你的脚本可能尝试分配过多内存,或者执行时间超过了IIS或PHP的限制。
- 解决方法：
- 在
php.ini中增加memory_limit的值，memory_limit = 256M。 - 增加
max_execution_time的值，max_execution_time = 300。
- 在
-
文件包含错误：
- 使用
include或require时,路径错误或文件不存在。 - 解决方法：检查所有包含文件的路径是否正确，使用绝对路径（如
__DIR__ . '/config.php'）可以避免很多问题。
- 使用
第四步：检查文件和目录权限
IIS默认在“应用程序池标识”下运行，这个标识（通常是 IIS_IUSRS 或 NETWORK SERVICE）需要对你网站目录中的文件有读取和执行权限。
-
确定应用程序池标识：
- 在IIS管理器中,点击你的网站。
- 在“操作”面板中，点击“基本设置...”。
- 记下“应用程序池”的名称。
- 然后点击服务器节点 -> "应用程序池"，找到刚才记下的池名称，右键点击 -> “高级设置...”，记下“进程模型”下的“标识”。
-
设置NTFS权限：
- 右键点击你的网站根目录 -> “属性” -> “安全”选项卡。
- 点击“编辑...” -> “添加...”。
- 输入你刚才记下的标识（
IIS_IUSRS），点击“检查名称” -> “确定”。 - 为这个用户分配以下权限：
- 读取 和 读取和执行：必须的,用于访问PHP文件。
- 列出文件夹内容：如果需要浏览目录。
- 写入：如果你的脚本需要上传文件或修改文件（如日志文件、缓存文件），则需要此权限。注意安全风险。
- 点击“确定”保存。
第五步：使用日志进行深度诊断
如果以上步骤都无法解决问题,日志就是你的救命稻草。
-
Windows事件查看器：
- 按
Win + R，输入eventvwr.msc并回车。 - 导航到 “Windows 日志” -> “应用程序” (Application)。
- 这里记录了由IIS、FastCGI等生成的系统级错误，查找来源为 "FastCGI" 或 "W3SVC" 的错误事件。
- 按
-
PHP错误日志：
- 回顾你在第一步中配置的
error_log文件（C:\php\logs\php_error.log）,这里记录了PHP脚本的所有运行时错误。
- 回顾你在第一步中配置的
-
IIS详细日志：
- 在IIS管理器中，点击你的网站 -> “日志”。
- 确保日志已启用，并选择一个日志文件（通常是
W3SVC1或类似的文件夹，按日期命名）。 - 用记事本或Excel打开这些日志。
