Flutter集成Firebase后iOS编译报错：闭包中需显式使用self访问属性

问题定位 #

这不是你的配置问题，是Firebase Storage官方Pod包的代码兼容性问题，和Swift的显式捕获语义规则冲突。Swift要求在闭包内引用类实例属性时，必须显式写上self.来明确捕获逻辑，但该Pod中的StorageListTask.swift代码未遵守这个规则，导致编译失败。

关于只读文件 #

报错涉及的StorageListTask.swift属于CocoaPods管理的第三方依赖文件，默认设置为只读，目的是防止用户误修改依赖库代码（修改后也会被后续pod install/update覆盖）。

解决方法 #

方法一：更新Firebase Storage到最新版本（推荐） #

官方大概率已经修复了这个语法问题，执行以下命令更新依赖：

pod update FirebaseStorage

更新完成后重新编译即可。

方法二：通过Podfile钩子放宽编译检查 #

如果暂时无法更新依赖，可以在iOS目录下的Podfile末尾添加以下代码，禁用Firebase Storage的警告转错误，并指定匹配的Swift版本：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    if target.name == 'FirebaseStorage'
      target.build_configurations.each do |config|
        config.build_settings['SWIFT_TREAT_WARNINGS_AS_ERRORS'] = 'NO'
        config.build_settings['SWIFT_VERSION'] = '5.0' # 替换为你的项目实际使用的Swift版本
      end
    end
  end
end

添加后执行pod install，再重新编译项目。

方法三：临时修改只读文件（不推荐） #

仅作为紧急临时方案，因为后续执行pod install/update会覆盖修改：

1. 找到报错的StorageListTask.swift文件，右键取消只读权限
2. 定位到第94行和第98行，分别将pageSize改为self.pageSize，previousPageToken改为self.previousPageToken
3. 保存后重新编译

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