如何解决Flutter Web应用部署至HostGator后无法访问的问题？

部署步骤 #

1. 执行命令构建发布版本：

   flutter build web --web-renderer canvaskit --release
   

2. 将构建输出压缩为ZIP，上传至cPanel文件管理器的public_html目录
   

此前DNS更新后3天内可正常上线，但此次等待后网站仍无法访问。

已尝试的排查操作 #

• 确认DNS设置正确指向HostGator服务器
• 验证public_html目录包含完整的Flutter构建文件

可能原因及解决方法 #

1. 文件解压路径错误 #

检查public_html根目录下是否直接存在index.html、assets、build等核心构建文件，而非嵌套在子文件夹中。如果解压后文件被放在子目录里，需将所有文件移动到public_html根目录。

2. 缓存干扰 #

• 登录cPanel，找到缓存管理工具（如站点缓存、Cloudflare缓存），手动清除全站缓存
• 浏览器强制刷新页面（Ctrl+Shift+R），绕过本地缓存

3. .htaccess配置缺失或错误 #

Flutter Web客户端路由需要mod_rewrite规则支持，在public_html下创建或修改.htaccess文件，添加以下内容：

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteRule ^index\.html$ - [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule . /index.html [L]
</IfModule>

若服务器未启用mod_rewrite，联系HostGator支持开启该模块。

4. 文件权限异常 #

将public_html及其子文件夹权限设为755，文件权限设为644。可在cPanel文件管理器中批量选择文件/文件夹，右键修改权限。

5. 域名绑定错误 #

在cPanel的“域名”管理模块中，确认域名已正确绑定到当前主机账户，且根目录指向public_html。

内容的提问来源于stack exchange，提问作者pomoworko.com