常见问题排查（QA）

• ​​主题安装之后，主页是白屏，后台也是？

  1. 主题文件夹记得选中箭头指向的复选框，之后刷新就可以了，如下图

  2. 还是不行就重新解压主题，解压之后直接给权限

     

‍

• 主题无法激活，或者激活失败，或者显示激活成功，但是无法进入设置

  1. 确保网站根目录有755权限。

  2. 确保主页可以正常访问。

  3. 问喵喵。

‍

• 主题设置中，新增加的复选框无法保存；

• 如遇到​​in_array(): Argument #2 ($haystack) must be of type array, null given​​报错

  或者​​in_array() expects parameter 2 to be array, null given in​​报错

  错误示例：

  

  此原因为typecho1.2.1的bug，喵喵发现已经在typecho1.3.0中解决，可以使用1.3.0正式版。

  typecho1.2.1手动修复方法：

  1. https://github.com/typecho/typecho/pull/1591/files/98e2011927f0c7253412abce0248c9ea2f9a7db0
  2. 看不懂的，就是删掉红的，新增绿的，然后左侧行号一致就行了，文件位置图片里也有。
  3. ​记得修改完成之后进主题设置（https://博客域名​/admin/options-theme.php ）保存一下。

  

  if (isset($this->options->{$key})) {
      $form->getInput($key)->value($this->options->{$key});
  }

‍

‍

• 微信公众号获取token失败：

1. 确保服务已经开启。

2. 确保服务器地址填写正确。

   1. 

3. 主题设置中填写了微信公众号token。

4. 查看文章点赞功能是否正常，如果点赞也出错请参考下侧QA优先解决点赞问题，之后重新尝试通过token验证。

5. 打开index.php​，将其中的A.php​修改为X.php后，重新尝试通过验证。如果成功之后记得改回。

6. 如果上述尝试均失败，可自行查阅百度或者联系微信客服，寻找token验证失败的解决方法，或者换个服务器环境重新尝试。

‍

‍

• 微信发图失败：
  详看微信公众号功能说明（基础·3.0新）[^1]的“重要”章节

‍

‍

• 微信发图经常发重复，或者微信发送成功但是博客不显示图片

  • 此问题多数为使用第三方图床的用户，可以尝试每次发送单张图片，且勿选择发送原图，即可避免此问题。

‍

‍

• 前台不能发文章？不能点赞？

1. 先检查是否设置了分类并选定了默认分类。

2. 部分用户可能需要去除禁用exec函数的限制。
   宝塔用户操作方法：

   1. 宝塔面板软件管理页面寻找到站点正在使用的php
   2. 进入php设置-禁用函数
   3. 找到exec函数，删除禁用限制即可

‍

• 头像不显示？或者加载很慢？
  在网站根目录中的config.inc.php文件中添加一行

  define('__TYPECHO_GRAVATAR_PREFIX__', 'https://cn.cravatar.com/avatar/');

  当然这里可以自定义为其他的头像源

‍

• 如何开启首页动态类型列表的评论功能？
  设置-评论-去除勾选“检查评论来源页 URL 是否与文章链接一致”复选框

‍

• 选择CMS模式主页报错500？
  确保未加密文章数量大于3

‍

• 好友标识或其他部分填写emoji会报错且无法保存？

  因为插件比较早，不支持emoji，因此为了更加美观，需要手动修改数据库以支持emoji。

• 1. 找到links表单，右侧可看到sort字段使用的是utf8，我们点击右侧的编辑。

     

  2. 在排序规则之中，找到并选中utf8mb4_general_ci，之后保存。

     

  3. 针对于其他的字段，譬如友链描述，也是这样操作的。

[^1]: # 微信公众号功能说明（基础·3.0新）

没什么可说的，具体的在设置项目下方的说明都有写，下面说一下关于微信公众号发送文章的功能。申请自己的微信公众号，来实时的发送说说内容。

# 创建

请先在微信公众平台申请微信公众号，个人可以选择订阅号。

[微信公众平台](https://mp.weixin.qq.com/)

在左侧下方“设置与开发--基本配置”中，开启第二项“服务器配置”

![image](https://image.mmbkz.cn/siyuan/2026/themedoc/20260628200014.png-thin)

1. URL请填写博客的api地址​ **【注意2.0版本之前这里填的是博客地址】** ：

   1. 默认没有开启伪静态是“博客主页地址”+“/index.php/api”：**https://www.mmbkz.cn/index.php/api**
   2. 如果开启了伪静态则是“博客主页地址”+“/api”：**https://www.mmbkz.cn/api**
2. Token请按小字要求自定义设置。
3. KEY随机生成即可。
4. 请选择​**兼容模式**。
5. 提交。
6. 开启服务。
7. token如果验证失败请查阅常见问题排查（Q/A）

‍

# 填入设置

1. 在主题设置中的位置，填写**微信公众号token**，并通过验证。
2. 使用自己的微信关注自己的公众号，发送红色文字：**获取openid**，此时会得到自己的openid，填入主题设置中的“管理员绑定**微信公众号的openid**”。
3. 如果发送“**获取openid**”没有得到回复内容，请检查是否绑定了ip白名单。

‍

# 使用方法

1. 直接发送文字，即可发送一条说说。

2. 直接发送图片，及为最新的一篇由微信发送的说说追加图片。

3. 直接发送视频或者语音，及为最新的一篇由微信发送的说说追加视频或者语音。【此功能为3.0进阶功能，请查看进阶部分说明】

4. 直接发送地理位置，及为最新的一篇由微信发送的说说追加地理位置。【此功能为3.0进阶功能，请查看进阶部分说明】

1.直接发送文字，即可发送一条说说。

5. 仅支持绑定用户发送内容。

‍

# 重要

如果​**使用本地图片存储**​，在使用微信发图之前，请手动按以下步骤修改，否则发不出图，可能会显示“公众号提供的服务出现故障”。​**使用图床插件的不受影响**，可以不改：

1. 定位到 `var/Widget/Upload.php`

2. 大概在389行

```PHP
if (!@move_uploaded_file($file['tmp_name'], $path)) {
    return false;
}
```
3. 将其中的`move_uploaded_file`​修改为`copy`

4. 现在支持的图床插件：

   1. 七牛云存储图床插件
   2. 又拍云存储图床插件
   3. Typecho-B2File图床插件
   4. typecho-cos-plugin图床插件
5. 如果使用的是typecho-cos-plugin图床插件，请在插件设置页面中手动填入域名地址，不要留空让其自动设置。
6. cos图床插件暂不支持CosForTypecho插件，请使用typecho-cos-plugin图床插件：[https://github.com/cnhongv/typecho-cos-plugin](https://github.com/cnhongv/typecho-cos-plugin)

‍