Typecho 文章保存 504 Gateway Time-out
一、故障概述
在 Typecho 博客系统执行文章保存操作（POST /action/contents-post-edit）时，页面返回 HTTP 504 Gateway Timeout 错误。对存储、资源、数据库及 PHP 环境进行分层排查后，确认底层运行正常，问题定位为反向代理超时配置。
二、排查过程与实证结果
1、存储系统验证
排查命令：在 Pod 内执行
time touch /var/www/html/nfs_test && echo "test">/var/www/html/nfs_test && rm /var/www/html/nfs_test
实测结果：
real 0m0.125s
user 0m0.000s
sys 0m0.001s结论：NFS 文件读写操作耗时仅 0.125 秒，无 I/O 延迟或挂载异常，可排除存储瓶颈。
2、资源使用率检查
排查命令：kubectl top pod miiv-lnp-557f547c45-d4745
实测结果：
NAME CPU(cores) MEMORY(bytes)
miiv-lnp-557f547c45-d4745 13m 25Mi结论：Pod CPU 使用率 13m、内存 25Mi，资源配额充足，无资源争抢或耗尽情况。
3、数据库状态分析
排查命令：SHOW FULL PROCESSLIST;
实测结果：
| Id | User | Host | db | Command | Time | State | Info |
| 404341 | root | localhost | NULL | Query | 0 | starting | SHOW FULL PROCESSLIST |
| 404377 | typecho | 10.42.2.3:45330 | typecho | Sleep | 61 | | NULL |
| 404378 | typecho | 10.42.2.3:45340 | typecho | Sleep | 61 | | NULL |结论：数据库连接均为 Sleep 状态，无长时间运行查询，无连接阻塞或死锁，负载正常。
4、PHP 执行能力测试
测试脚本：创建 PHP 文件模拟耗时操作，访问
<?php
echo "Start: " . date('Y-m-d H:i:s') . "\n";
sleep(2); // 模拟耗时操作
echo "End: " . date('Y-m-d H:i:s') . "\n";
?>实测结果：
Start: 2026-05-02 12:56:03
End: 2026-05-02 12:56:05结论：PHP-FPM 可正常处理 2 秒耗时请求，脚本执行不受限制，应用层基础处理能力无异常。
5、故障日志定位
日志内容：
10.42.1.2 - - [02/May/2026:12:44:32 +0000] "POST /action/contents-post-edit?_=94be44fc416e098a75bd09ba9d85aec0 HTTP/1.1" 504 569关键信息：文章保存请求触发 504 超时，与 PHP 正常处理能力测试结果不一致。
结论：问题并非应用层逻辑错误，而是网关层超时配置导致。
6、调整反向代理超时配置
修改 Nginx 或 Ingress Controller 配置，增加proxy_read_timeout和proxy_send_timeout值（建议设置为 120 秒以上）
示例配置（Nginx）：
location~\.php$ {
proxy_read_timeout 120s;
proxy_send_timeout 120s;
}重新发布文章发现正常（耗时还是有问题）
三、根因分析
综合实测数据，系统底层环境（存储、资源、数据库、PHP）均无异常。HTTP 504 错误本质为反向代理等待后端响应超过预设超时阈值。PHP 可正常处理 2 秒耗时请求，说明基础执行能力正常；但文章保存操作可能包含额外处理逻辑（如插件触发、缓存更新等），导致总耗时超过网关默认超时时间（通常为 60 秒）。
四、解决方案
关闭Typecho中的AISummary插件正常
