安装完主题后，页面中间部分空白/安装后首页报错，500错误

如果因为任何原因导致了「启用主题」失败， 后续解决了启用主题失败的问题，都需要切换到别的主题再切换回来（切换主题过程会清空原来的配置并且还原默认配置），确保默认的设置可以设置成功 ，因为「启用主题」失败的时候，默认的初始化数据都没有设置成功的，会导致主题使用过程中的一些其它问题，比如评论头像不显示等等。

• typecho至少为1.0版本，不支持0.9版本！！！typecho 1.2版本需要使用 handsome8.3 及其以上版本（typecho1.2版本不要使用开发版本，需要使用正式版本，开发版本会在某些服务器上无法保存设置数据）
• 依次检查主题文件夹名称是否为 handsome（首字母不用大写），插件文件夹名称为 Handsome（首字母大写）
• 是否已经安装并且启用主题必要的插件Handsome

• 服务器环境检查 ：

  • php版本需要5.6及其以上版本，必须安装curl、mbstring、openssl、json、zlib扩展 ，否则无法使用（正确检查方式是在你的服务器新建一个 test.php，然后复制粘贴该代码 <?php phpinfo(); ?>，最后在浏览器访问该文件可以查看服务器的php信息，一般自己手动编译的php库可能会有这个问题）
  • windows 服务器 php 版本请使用 5.6 暂不支持 php7 （目前排查问题可能是 xampp 的某个问题导致，暂时无法解决）。
  • Linux 服务器可以支持 php7、8（php8 需要最新版本主题和 typecho 仓库的最新代码）
  • 老薛主机不支持php8，可以使用php7.x 或者php5.6及其以上版本
• 主题目录给777权限，包括递归子文件夹和子文件，也可以尝试给644或者755权限。因为有的服务器上传文件之后，默认给的权限php都没办法执行的
• 初次使用主题必须保证博客有一篇文章，如果一篇文章都没有的话会导致向数据库中添加view（浏览次数字段）失败
• 如果你的 typecho 版本是好久之前的开发版本，需要升级到最新的 typecho 1.2 版本
• 最后确保自己上传的文件没有缺失，比如handsome文件夹下有fucntions.php，Handsome文件夹下有Plugin.php 则是最起码的

Handsome插件无法启用，显示Database Query Error

• 原因是文章太多，在首次启用插件的时候会构建搜索缓存，缓存大小超过了mysql的默认设置
• 在mysql中的控制执行下面的sql语句：

SET GLOBAL max_allowed_packet=4294967295;

如果你装了phpmyadmin的mysql控制台面板，在如下图的位置执行：

如果执行上面语句成功后，还是无法启用插件，可以参考这里https://blog.csdn.net/wanbin6470398/article/details/81633922 修改innodb_log_file_size 变量的大小，修改值为2G。如果是宝塔面板，就是如下的设置位置，修改配置保存后，再次重启mysql服务即可。

打开 handsome 外观设置/插件设置界面显示后1s后白屏

• 按照上一条中的「服务器环境检查」检查服务器配置是否正常
• 检查 typecho 目录下的 index.php 或者 config.inc.php 文件最上面是不是自己修改多了空行，或者多了自己添加的注释
• 确保functions.php 头部的 //如果需要显示php错误打开这两行注释，问题修复后必须关闭！ 这一行注释下面的两行是注释的，上面两行是没有注释的。
• 确认Handsome插件和handsome主题文件夹命名是否正确（Handsome插件文件夹首字母需要大写，handsome主题文件夹首字母不用大写），同时确认Handsome插件版本与主题版本一致。
• 检查typecho 列表中是否错误的插件（“此插件文件已经损坏或者被不安全移除，强烈建议你禁用它” 这样提示的插件需要禁用）

启动主题后，首页的样式不正常（如左侧边栏黑色，很多样式和我的博客不一致）

• 原因是第一次启用主题的时候默认的配置没有初始化成功导致的
• 可以切换到别的主题，再切换回来恢复默认的主题设置即可

启动主题，主题列表中没有主题，甚至其他主题都不显示了

• 主题目录给777或者755权限包括递归子文件夹和子文件 ，Linux是在 usr/themes/目录下执行 chmod -R 777 ./ 必须包含 -R 参数，表示递归执行。
• 检查typecho 目录下的 usr/themes/handsome 目录下是否是一系列主题文件，而不是另一个嵌套的文件夹
• 确定 php 版本是5.6 ~ 8.0，如果是 Windows 服务器尝试使用低版本 php，如 php5.6

AppNode 面板启用主题会出错

该问题是app node 面板版本的是一个bug，具体见：https://bbs.appnode.com/thread-2621.htm

解决方法：

• 找到正在使用的php版本的 php.ini 文件
• 在该文件中搜索 max_execution_time，将后面的值 0d 改成0，不需要后面的单位，然后保存。
• 最后重启一下php服务， 切记后续不要在面板中修改配置！！ 否则 max_execution_time的值又会变成0d了。

友情链接栏目点击/添加友情链接显示404

依次按照下面操作进行检查：

• 禁用Handsome插件后再启用一下试试
• 检查Handsome插件文件夹首字母是否是大写
• 重新安装Handsome插件（删除旧的Handsome文件夹），确保文件上传没有遗漏，没有漏上传，自己比较一下下载的本地文件和服务器上的文件是不是一致
• 请勿安装第三方Links插件 ，如果已经安装了，先禁用Links插件，再删除Links插件，最后一样再按照上面的前三条依次操作检查。