[Bug] 前端资源 (index-XPEyFLDL.js) 被当作 text/plain 类型加载，而不是预期的 application/javascript，导致浏览器无法执行 JavaScript

[heraclitus-1112]

What happened / 发生了什么

win安装astrbot后在终端显示能正常运行，但打开webui白屏

Reproduce / 如何复现？

win版本装好后首次打开webui就白屏，不知道如何复现

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

atsrbot4.20.0，win部署

OS

Windows

Logs / 报错日志

网页f12：Failed to load module script: Expected :6185/assets/index-XPEyFLDL.js:1
The server responded with a MIME type of "text/plain". Strict MIME type checking is enforced for module scripts per HTML spec.
ps（似乎正常）：Welcome to AstrBot CLI!
AstrBot CLI version: 4.20.0
[17:30:50.035] [Core] [DBUG] [agent.tool_image_cache:55]: ToolImageCache initialized, cache dir: D:\astrbot\data\temp\tool_images
[17:30:50.112] [Core] [DBUG] [faiss.loader:96]: Environment variable FAISS_OPT_LEVEL is not set, so let's pick the instruction set according to the current CPU
[17:30:50.113] [Core] [INFO] [faiss.loader:132]: Loading faiss with AVX2 support.
[17:30:50.127] [Core] [INFO] [faiss.loader:134]: Successfully loaded faiss with AVX2 support.
[17:30:50.371] [Core] [DBUG] [platform.register:60]: 平台适配器 aiocqhttp 已注册
[17:30:50.393] [Core] [DBUG] [platform.register:60]: 平台适配器 wecom_ai_bot 已注册
[17:30:50.398] [Core] [DBUG] [platform.register:60]: 平台适配器 webchat 已注册
Dashboard is already up to date
[17:30:50.440] [Core] [DBUG] [core.core_lifecycle:80]: HTTP proxy cleared
[17:30:50.440] [Core] [INFO] [core.core_lifecycle:106]: AstrBot v4.20.0
[17:30:50.653] [Core] [INFO] [core.persona_mgr:38]: 已加载 0 个人格。
[17:30:50.659] [Core] [INFO] [star.star_manager:744]: 正在载入插件 astrbot ...
[17:30:50.664] [Core] [INFO] [star.star_manager:828]: Plugin astrbot (4.1.0) by Soulter: AstrBot 自带插件，包含人格注入、思考内容注入、群聊上下文感知等功能的实现，禁用后将无法使用这些功能。
[17:30:50.665] [Core] [INFO] [star.star_manager:744]: 正在载入插件 builtin_commands ...
[17:30:50.731] [Core] [INFO] [star.star_manager:828]: Plugin builtin_commands (0.0.1) by Soulter: AstrBot 自带指令，提供常用的对话管理、工具使用、插件管理等功能。
[17:30:50.731] [Core] [INFO] [star.star_manager:744]: 正在载入插件 session_controller ...
[17:30:50.734] [Core] [INFO] [star.star_manager:828]: Plugin session_controller (v1.0.1) by Cvandia & Soulter: 为插件支持会话控制
[17:30:50.734] [Core] [INFO] [star.star_manager:744]: 正在载入插件 web_searcher ...
[17:30:50.812] [Core] [INFO] [provider.func_tool_manager:304]: 添加函数调用工具: web_search
[17:30:50.828] [Core] [INFO] [provider.func_tool_manager:304]: 添加函数调用工具: fetch_url
[17:30:50.849] [Core] [INFO] [provider.func_tool_manager:304]: 添加函数调用工具: web_search_tavily
[17:30:50.865] [Core] [INFO] [provider.func_tool_manager:304]: 添加函数调用工具: tavily_extract_web_page
[17:30:50.885] [Core] [INFO] [provider.func_tool_manager:304]: 添加函数调用工具: web_search_bocha
[17:30:50.889] [Core] [INFO] [star.star_manager:828]: Plugin astrbot-web-searcher (1.14.514) by Soulter: 让 LLM 具有网页检索能力
[17:30:50.904] [Core] [INFO] [knowledge_base.kb_mgr:40]: 正在初始化知识库模块...
[17:30:50.918] [Core] [INFO] [knowledge_base.kb_mgr:66]: KnowledgeBase database initialized: D:\astrbot\data\knowledge_base\kb.db
[17:30:51.739] [Core] [INFO] [dashboard.server:331]: 正在启动 WebUI, 监听地址: http://0.0.0.0:6185
[17:30:51.740] [Core] [INFO] [dashboard.server:333]: 提示: WebUI 将监听所有网络接口，请注意安全。（可在 data/cmd_config.json 中配置 dashboard.host 以修改 host）
[17:30:53.784] [Core] [INFO] [dashboard.server:370]:
✨✨✨
AstrBot v4.20.0 WebUI 已启动，可访问

[17:30:53.785] [Core] [INFO] [core.core_lifecycle:297]: AstrBot 启动完成。
[17:30:53.789] [Core] [INFO] [utils.temp_dir_cleaner:127]: TempDirCleaner started. interval=600s cleanup_ratio=0.3
[2026-03-14 17:30:53 +0800] [26672] [INFO] Running on http://0.0.0.0:6185 (CTRL + C to quit)
[17:30:54.303] [Core] [INFO] [utils.llm_metadata:63]: Successfully fetched metadata for 2098 LLMs.
[17:30:54.631] [Core] [INFO] [t2i.network_strategy:56]: Successfully got 2 official T2I endpoints.

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

Hi @heraclitus-1112! I'm Dosu and I’m helping the AstrBot team.

这是一个已知问题，在 Windows 环境下 Python 的 mimetypes 模块可能无法正确识别 JavaScript 文件类型，导致返回 text/plain。

推荐解决方案：手动替换前端资源

1. 从 AstrBot Release 页面 下载对应版本的 dist.zip
2. 解压后用 dist 文件夹完整覆盖 data/dist 目录
3. 强制刷新浏览器（Ctrl+F5）

PR #3281 已修复此问题，在启动时添加了正确的 MIME type 配置。如果该修复已包含在 4.20.0 中但问题仍然存在，手动替换 dist 文件夹是最直接有效的方案。

你也可以检查 data/dist 目录下的前端文件是否完整存在。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

  

[heraclitus-1112]

我下载了release中的4.20版本的dashboard.zip中的dist文件夹并进行了覆盖，然后我重新运行astrbot并强制刷新，但是仍然白屏，f12中仍为原问题

[dosubot]

注意应该使用 dist.zip 而非 dashboard.zip。请确认下载的是正确的文件。

如果已经是 dist.zip，请尝试以下步骤：

1. 完全删除 现有的 data/dist 目录（不是覆盖，是删除后重建）
2. 解压 dist.zip 得到新的 dist 文件夹
3. 将新的 dist 文件夹放入 data/ 目录
4. 重启 AstrBot 并强制刷新浏览器（Ctrl+F5）

另外，请在浏览器开发者工具（F12）的 Network 标签页中检查 index-*.js 文件的 Response Headers，确认 Content-Type 是什么值。这可以帮助确定问题是否仍然是 MIME type 错误，还是其他原因。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

  

[heraclitus-1112]

release里面没有找到dist.zip

[dosubot]

你可以尝试以下方法：

1. 删除 data/dist 文件夹后重启 AstrBot，系统会自动从服务器下载最新的前端资源

2. 或者直接从以下链接手动下载：

   • https://github.com/AstrBotDevs/AstrBot/releases/latest/download/dist.zip

下载后解压到 data/ 目录下，确保存在 data/dist 文件夹结构。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}