Flutter Web构建缺失manifest.json文件问题求助

问题分析 #

你的index.html里引用了manifest.json，但项目的web目录下没有这个文件，且Flutter构建过程不会自动生成它，最终导致部署时出现“Unable to find manifest.json”错误。

解决方案 #

1. 手动创建manifest.json文件 #

在项目的web目录下新建manifest.json文件，添加Flutter Web默认配置内容（可根据应用需求修改）：

{
    "name": "你的应用名称",
    "short_name": "应用简称",
    "start_url": ".",
    "display": "standalone",
    "background_color": "#0175C2",
    "theme_color": "#0175C2",
    "description": "应用描述",
    "orientation": "portrait-primary",
    "prefer_related_applications": false,
    "icons": [
        {
            "src": "icons/Icon-192.png",
            "sizes": "192x192",
            "type": "image/png"
        },
        {
            "src": "icons/Icon-512.png",
            "sizes": "512x512",
            "type": "image/png"
        }
    ]
}

注：如果web/icons目录下没有对应图标文件，可暂时移除icons数组（不影响基础功能，但会丢失PWA图标支持）。

2. 检查index.html中的引用正确性 #

确保web/index.html里的manifest引用路径无误、无拼写错误：

<link rel="manifest" href="manifest.json">

若manifest放在子目录中，需调整href的相对路径。

3. 清理缓存并重新构建 #

执行以下命令清理旧构建缓存，再重新生成生产构建：

flutter clean
flutter build web --release

完成后检查build/web目录，确认manifest.json已被包含。

4. 排查文件忽略规则 #

检查项目根目录的.gitignore或其他忽略配置文件，确保未将manifest.json或web/目录下的文件排除，避免构建时被跳过。

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