安裝完主題后,頁面中間部分空白/安裝后首頁報錯,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了。

image-20220410171307643

友情鏈接欄目點擊/添加友情鏈接顯示404

依次按照下面操作進行檢查:

  • 禁用Handsome插件后再啟用一下試試
  • 檢查Handsome插件文件夾首字母是否是大寫
  • 重新安裝Handsome插件(刪除舊的Handsome文件夾),確保文件上傳沒有遺漏,沒有漏上傳,自己比較一下下載的本地文件和服務器上的文件是不是一致
  • 請勿安裝第三方Links插件 ,如果已經安裝了,先禁用Links插件,再刪除Links插件,最后一樣再按照上面的前三條依次操作檢查。
最后修改:
如果覺得我的文章對你有用,請隨意贊賞