进阶 yourls.org 2026-11-19 17:39:56 · 1 阅读

第31章 初步排查

第31章 初步排查

遇到问题了?某些功能没按预期工作?在提交新 issue 之前,请先花点时间按下面的步骤排查。

仔细检查你的 config.php

99% 的情况下,错误都是由用户在配置文件或服务器配置中出错导致的。

请仔细检查你的配置,阅读 YOURLS 自带的 readme 以及本文档中的所有相关页面。

禁用插件

确认问题不是由某个插件引起的。先把所有插件禁用,看看问题是否消失;如果消失了,再逐个启用插件并每次都进行测试,直到找出罪魁祸首。问题可能出在某个插件本身,也可能是两个插件之间相互冲突。

开启调试模式

默认情况下,YOURLS 会隐藏大部分错误信息,这可能导致出现空白页面(也就是可怕的“白屏死机”)。开启调试模式即可显示所有错误和警告,只需在 config.php 的任意位置添加以下一行:

```php define( 'YOURLS_DEBUG', true ); ```

查看此页了解更多高级调试技巧:[调试](#)。 使用最新发行版 如果某些功能未按预期工作且确认为 bug,请确认你使用的是最新版本。每个版本都会修复若干 bug。 检查 .htaccess / web.config 参见“服务器配置”页。 检查服务器日志 若错误发生在服务端(例如页面生成时出现错误),服务器日志中通常能找到有价值的相关信息。 根据服务器软件和配置不同,该文本文件可能位于 /var/log/apache2/error.log、/usr/local/apache/logs/error_log、/xampp/apache/logs/error.log 等位置。 若不清楚错误日志的位置,可在 Apache 配置中查找 ErrorLog 指令。若不确定如何操作,请咨询服务器管理员。 使用浏览器开发者工具 若错误发生在客户端(例如页面正常生成,但与页面交互时出现问题),请排查 Ajax 请求中的 JavaScript 错误。 根据浏览器不同,可通过 Firefox 的 Firebug 扩展或 Chrome DevTools 等工具完成。网上有大量相关指南(例如“如何调试 Chrome 中的 Ajax”)。 读完手册后,再去搜全网(STFW) 如果你已经仔细查阅过官方文档(RTFM,Read The Fine Manual)但依然困惑,请去搜索整个互联网(STFW,Search The Fine Web)。成千上万的人很可能已遇到过相同问题,且很可能已有记录。 特别是,务必搜索所有 issue(无论 open 还是 closed)。你的问题可能早已被处理过。 提交规范的 issue 提交措辞不当或不完整的 issue 只会浪费每个人的时间。这并不复杂,提交前请先阅读贡献指南。

评论 (0)