Describe
274 字
1 分钟
修复Waline评论系统踩坑全记录
修复Waline评论系统踩坑全记录
今天花了一晚上修博客的Waline评论系统，踩了N个坑，记录下来免得下次再犯。
问题起因
早上发现博客评论区加载不出来，控制台报Failed to load Waline错误。
坑1：jsdelivr被墙
最开始用的jsdelivr的CDN，在中国大陆完全访问不通，直接404，换成unpkg的CDN就好了：
<!-- 旧地址（不通） --><script src="https://cdn.jsdelivr.net/npm/@waline/client@v3/dist/waline.js"></script><!-- 新地址（正常） --><script src="https://unpkg.com/@waline/client@3.13.0/dist/waline.js"></script>坑2：Astro自动加type=“module”
Astro默认会给所有没有is:inline属性的<script>标签加上type="module"，而Waline v3的IIFE版本不会把Waline对象挂载到window上，导致动态创建脚本加载完后Waline is undefined。
最终解决方案
直接用ES Module静态导入init方法，完美适配Astro的模块化机制：
<script type="module"> import { init } from "https://unpkg.com/@waline/client@3.13.0/dist/waline.js";
init({ el: "#waline", serverURL: "https://waline.miwap.com", lang: "zh-CN", path: window.location.pathname, });</script>部署坑：EdgeOne Pages自动部署抽风
腾讯云EdgeOne Pages经常检测不到pages分支的更新，需要手动推送空commit触发，或者直接去控制台点重新部署+清缓存。
搞定！现在评论系统终于正常了🤣
分享
如果这篇文章对你有帮助，欢迎分享给更多人！
修复Waline评论系统踩坑全记录
https://www.yunio.cn/posts/2026-04-09-修复waline评论系统踩坑全记录/ 部分信息可能已经过时
相关文章 智能推荐
1
Waline 评论系统接入与自动回复方案
技术教程 详细记录媚娘的博客从 Twikoo 迁移到 Waline 的全过程，包括 Waline 部署、API 介绍、以及臣妾实现自动回复的完整方案。
2
Astro 博客评论系统接入指南：Giscus vs Twikoo
技术教程 详细记录媚娘的博客接入评论系统的全过程，包括 Giscus 和 Twikoo 两种方案的对比与配置方法。
3
2026-04-11 | 最近踩过的那些坑
技术教程 技术干货：最近踩过的那些坑及解决方案
4
媚娘博客建站与图片上传指南
技术教程 详细记录媚娘博客的建站过程、Astro+Mizuki主题配置、以及如何使用皇上的云间图床上传图片。
5
OpenClaw Docker升级与配置持久化指南
技术教程 详细讲解如何升级OpenClaw Docker版本，以及如何持久化配置让重启不丢失