iOS Universal Link未触发App首页路由问题（Go Router）

结合你提供的Go Router代码和问题现象，以下是几个可能导致首页"/"路由无法触发的原因：

1. AASA 文件路径配置缺失 #

Apple App Site Association（AASA）文件是Universal Link生效的核心配置，若文件中未明确包含根路径的匹配规则，iOS不会将首页的Universal Link导向你的App：

• 检查AASA的paths数组，确保包含"/"或"/*"（后者匹配所有子路径，包括根路径）。如果仅配置了"/jobs/*"，根路径的链接会直接在Safari打开，不会触发App跳转。
• 确认AASA文件格式无误，比如数组条目是否用双引号包裹、逗号是否正确分隔，语法错误会导致整个配置失效。

2. iOS 关联域名配置遗漏 #

Xcode中若未正确配置关联域名，根路径的Universal Link无法被App识别：

• 进入Xcode项目的Signing & Capabilities，检查Associated Domains中是否添加了applinks:你的域名，注意域名前不要加http://或https://，也不要带末尾斜杠。

3. Universal Link 的URL传递逻辑问题 #

iOS端的URL回调若未正确将根路径URL传递给Go Router，会导致路由不触发：

• 检查AppDelegate或SceneDelegate中的URL处理方法（如application(_:continue:restorationHandler:)或scene(_:openURLContexts:)），确保将接收到的URL完整传递给Flutter的Go Router。例如，若回调中过滤了根路径的URL，就会导致跳转失败。

4. 缓存导致的配置未生效 #

iOS会缓存AASA文件和Universal Link关联信息，即使你更新了配置，旧缓存可能仍在生效：

• 直接卸载重装App，这是清除Universal Link缓存最直接的方式。
• 若网页端首页有JS重定向逻辑，可能导致Universal Link未被正确识别，检查首页是否存在自动跳转行为干扰链接触发。

5. Go Router 路由匹配的隐性问题 #

虽然你的代码中已配置"/"路由，但仍需确认：

• 是否存在全局重定向逻辑（比如未在代码中展示的redirect参数）拦截了根路径的匹配。
• 测试时是否传递的是纯根路径URL，若URL带额外参数（如/?param=1），可以在根路由中添加日志打印，确认Go Router是否接收到了该URL。

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