# 常见错误与日志分析

URL: https://caijiao.org/nginx/troubleshooting
Source: docs/nginx/troubleshooting.md
Description: 本节介绍 Nginx 常见错误类型及日志分析方法，包括访问日志、错误日志、调试技巧和排错流程，帮助快速定位问题并优化服务。

在 Nginx 运维中，常见错误可能导致服务不可用，通过日志分析可以快速排查问题。

## 一、访问错误

- **404 Not Found**：请求资源不存在  
  - 检查 `root` 或 `alias` 配置  
  - 确认文件路径和权限  

- **403 Forbidden**：权限不足  
  - 检查文件夹和文件权限  
  - 检查 `deny` 或 `allow` 配置  

## 二、服务器错误

- **500 Internal Server Error**  
  - PHP-FPM 或后端应用异常  
  - 查看 `error_log` 了解具体报错  

- **502 Bad Gateway / 504 Gateway Timeout**  
  - 后端服务不可达或超时  
  - 检查 `proxy_pass` 配置和后端健康状态  

## 三、日志分析方法

```nginx
access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log warn;
````

- **access_log**：记录访问日志，分析请求来源和访问频率
- **error_log**：记录错误日志，调试和排错

### 实用技巧

1. 使用 `tail -f /var/log/nginx/error.log` 实时查看错误
2. 使用 `grep` 筛选关键字，如 `grep 500 error.log`
3. 配合日志分析工具（GoAccess、AWStats）统计访问数据

## 四、排错流程

1. 查看错误日志确定错误类型
2. 检查配置文件语法：`nginx -t`
3. 检查服务状态：`systemctl status nginx`
4. 针对 PHP-FPM 或后端服务进行调试
5. 调整配置并重载：`nginx -s reload`

---

通过合理分析日志和掌握常见错误处理方法，可以快速定位问题，提高 Nginx 服务的稳定性和可用性。