Loading... #### [安裝完主題后,頁面中間部分空白/安裝后首頁報錯,500錯誤](https://auth.ihewro.com/user/docs/#/FAQ/install?id=%e5%ae%89%e8%a3%85%e5%ae%8c%e4%b8%bb%e9%a2%98%e5%90%8e%ef%bc%8c%e9%a1%b5%e9%9d%a2%e4%b8%ad%e9%97%b4%e9%83%a8%e5%88%86%e7%a9%ba%e7%99%bd%e5%ae%89%e8%a3%85%e5%90%8e%e9%a6%96%e9%a1%b5%e6%8a%a5%e9%94%99%ef%bc%8c500%e9%94%99%e8%af%af) 如果因為任何原因導致了「啟用主題」失敗, **后續解決了啟用主題失敗的問題,都需要切換到別的主題再切換回來(切換主題過程會清空原來的配置并且還原默認配置),確保默認的設置可以設置成功** ,因為「啟用主題」失敗的時候,默認的初始化數據都沒有設置成功的,會導致主題使用過程中的一些其它問題,比如評論頭像不顯示等等。 * 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](https://auth.ihewro.com/user/docs/#/FAQ/install?id=handsome%e6%8f%92%e4%bb%b6%e6%97%a0%e6%b3%95%e5%90%af%e7%94%a8%ef%bc%8c%e6%98%be%e7%a4%badatabase-query-error) * 原因是文章太多,在首次啟用插件的時候會構建搜索緩存,緩存大小超過了mysql的默認設置 * 在mysql中的控制執行下面的sql語句: ``` SET GLOBAL max_allowed_packet=4294967295; ``` 如果你裝了phpmyadmin的mysql控制臺面板,在如下圖的位置執行:  如果執行上面語句成功后,還是無法啟用插件,可以參考這里[https://blog.csdn.net/wanbin6470398/article/details/81633922](https://blog.csdn.net/wanbin6470398/article/details/81633922) 修改innodb_log_file_size 變量的大小,修改值為2G。如果是寶塔面板,就是如下的設置位置,修改配置保存后,再次重啟mysql服務即可。  #### [打開 handsome 外觀設置/插件設置界面顯示后1s后白屏](https://auth.ihewro.com/user/docs/#/FAQ/install?id=%e6%89%93%e5%bc%80-handsome-%e5%a4%96%e8%a7%82%e8%ae%be%e7%bd%ae%e6%8f%92%e4%bb%b6%e8%ae%be%e7%bd%ae%e7%95%8c%e9%9d%a2%e6%98%be%e7%a4%ba%e5%90%8e1s%e5%90%8e%e7%99%bd%e5%b1%8f) * 按照上一條中的「服務器環境檢查」檢查服務器配置是否正常 * 檢查 typecho 目錄下的 index.php 或者 config.inc.php 文件最上面是不是自己修改多了空行,或者多了自己添加的注釋 * 確保functions.php 頭部的 `//如果需要顯示php錯誤打開這兩行注釋,問題修復后必須關閉!` 這一行注釋下面的兩行是注釋的,上面兩行是沒有注釋的。 * 確認Handsome插件和handsome主題文件夾命名是否正確(Handsome插件文件夾首字母需要大寫,handsome主題文件夾首字母不用大寫),同時確認Handsome插件版本與主題版本一致。 * 檢查typecho 列表中是否錯誤的插件(“此插件文件已經損壞或者被不安全移除,強烈建議你禁用它” 這樣提示的插件需要禁用) #### [啟動主題后,首頁的樣式不正常(如左側邊欄黑色,很多樣式和我的博客不一致)](https://auth.ihewro.com/user/docs/#/FAQ/install?id=%e5%90%af%e5%8a%a8%e4%b8%bb%e9%a2%98%e5%90%8e%ef%bc%8c%e9%a6%96%e9%a1%b5%e7%9a%84%e6%a0%b7%e5%bc%8f%e4%b8%8d%e6%ad%a3%e5%b8%b8%ef%bc%88%e5%a6%82%e5%b7%a6%e4%be%a7%e8%be%b9%e6%a0%8f%e9%bb%91%e8%89%b2%ef%bc%8c%e5%be%88%e5%a4%9a%e6%a0%b7%e5%bc%8f%e5%92%8c%e6%88%91%e7%9a%84%e5%8d%9a%e5%ae%a2%e4%b8%8d%e4%b8%80%e8%87%b4%ef%bc%89) * 原因是第一次啟用主題的時候默認的配置沒有初始化成功導致的 * 可以切換到別的主題,再切換回來恢復默認的主題設置即可 #### [啟動主題,主題列表中沒有主題,甚至其他主題都不顯示了](https://auth.ihewro.com/user/docs/#/FAQ/install?id=%e5%90%af%e5%8a%a8%e4%b8%bb%e9%a2%98%ef%bc%8c%e4%b8%bb%e9%a2%98%e5%88%97%e8%a1%a8%e4%b8%ad%e6%b2%a1%e6%9c%89%e4%b8%bb%e9%a2%98%ef%bc%8c%e7%94%9a%e8%87%b3%e5%85%b6%e4%bb%96%e4%b8%bb%e9%a2%98%e9%83%bd%e4%b8%8d%e6%98%be%e7%a4%ba%e4%ba%86) * 主題目錄給777或者755權限包括遞歸子文件夾和子文件 ,Linux是在 `usr/themes/`目錄下執行 `chmod -R 777 ./` 必須包含 `-R` 參數,表示遞歸執行。 * 檢查typecho 目錄下的 `usr/themes/handsome` 目錄下是否是一系列主題文件,而不是另一個嵌套的文件夾 * 確定 php 版本是5.6 ~ 8.0,如果是 Windows 服務器嘗試使用低版本 php,如 php5.6 #### [AppNode 面板啟用主題會出錯](https://auth.ihewro.com/user/docs/#/FAQ/install?id=appnode-%e9%9d%a2%e6%9d%bf%e5%90%af%e7%94%a8%e4%b8%bb%e9%a2%98%e4%bc%9a%e5%87%ba%e9%94%99) 該問題是app node 面板版本的是一個bug,具體見:[https://bbs.appnode.com/thread-2621.htm](https://bbs.appnode.com/thread-2621.htm) 解決方法: * 找到正在使用的php版本的 php.ini 文件 * 在該文件中搜索 `max_execution_time`,將后面的值 0d 改成0,不需要后面的單位,然后保存。 * 最后重啟一下php服務, **切記后續不要在面板中修改配置??!** 否則 `max_execution_time`的值又會變成0d了。  #### [友情鏈接欄目點擊/添加友情鏈接顯示404](https://auth.ihewro.com/user/docs/#/FAQ/install?id=%e5%8f%8b%e6%83%85%e9%93%be%e6%8e%a5%e6%a0%8f%e7%9b%ae%e7%82%b9%e5%87%bb%e6%b7%bb%e5%8a%a0%e5%8f%8b%e6%83%85%e9%93%be%e6%8e%a5%e6%98%be%e7%a4%ba404) 依次按照下面操作進行檢查: * 禁用Handsome插件后再啟用一下試試 * 檢查Handsome插件文件夾首字母是否是大寫 * 重新安裝Handsome插件(刪除舊的Handsome文件夾),確保文件上傳沒有遺漏,沒有漏上傳,自己比較一下下載的本地文件和服務器上的文件是不是一致 * **請勿安裝第三方Links插件** ,如果已經安裝了,先禁用Links插件,再刪除Links插件,最后一樣再按照上面的前三條依次操作檢查。 最后修改: ? 允許規范轉載 打賞 贊賞作者 支付寶微信 贊 如果覺得我的文章對你有用,請隨意贊賞