多款Flask应用突然出现本地JavaScript脚本无法执行问题

1. 检查Blueprint静态文件路由匹配 #

你的模板中JS路径用的是/static/js/xxx.js，但Blueprint默认的静态文件URL前缀是/<blueprint_name>/static（比如你的auth蓝图就是/auth/static）。如果Flask主应用的根静态文件夹没有这些JS文件，就会返回404导致加载失败：

• 建议用Flask的url_for生成正确路径，替换模板中的硬编码：{{ url_for('auth.static', filename='js/jquery.min.js') }}
• 或者在Blueprint初始化时强制指定静态文件根路径：

auth = Blueprint(
    "auth",
    __name__,
    template_folder="templates",
    static_folder='static',
    static_url_path='/static'
)

2. 查看浏览器控制台具体错误码 #

不要只看“拒绝加载”提示，打开控制台「网络」标签，查看JS请求的状态码：

• 404：路径错误，回到第一步检查路由配置；
• 403：权限问题，检查本地文件或服务器权限；
• 500：Flask内部错误，查看终端的报错信息；
• MIME类型错误：可能文件损坏，尝试重新拉取静态文件。

3. 检查Windows本地文件权限 #

Windows文件系统权限可能阻止Flask读取静态文件：

• 右键static文件夹→「属性」→「安全」，确保当前用户拥有「读取」权限；
• 取消文件夹的「只读」属性（应用到所有子文件和子文件夹）。

4. 排查杀毒软件/防火墙拦截 #

Windows下杀毒软件或防火墙可能突然拦截本地服务器请求：

• 临时关闭杀毒软件和防火墙，重新运行Flask测试；
• 如果恢复正常，将Flask运行端口或项目文件夹加入信任列表。

5. 清理浏览器缓存或使用无痕模式 #

旧缓存可能导致加载异常：

• 用Ctrl+Shift+Delete清空浏览器缓存（选择“缓存的图片和文件”）；
• 打开无痕/隐私窗口访问应用，排除缓存干扰。

6. 检查Flask版本与配置差异 #

对比Linux环境的Flask版本，确认本地环境是否有版本更新：

• 运行pip show flask查看本地版本，和其他开发者的Linux环境版本对比；
• 检查Flask配置是否修改过SEND_FILE_MAX_AGE_DEFAULT、USE_X_SENDFILE等影响静态文件处理的参数。

7. 验证静态文件完整性 #

确认本地静态文件未损坏：

• 对比Linux环境下的静态文件MD5值，或重新从版本库拉取静态文件；
• 直接访问静态文件URL（比如http://localhost:5000/auth/static/js/jquery.min.js），检查是否能正常下载。

内容的提问来源于stack exchange，提问作者ghawes