使用Gin-Gonic框架时iPhone无法设置Cookie的问题排查

针对你遇到的iOS端无法接收Cookie、返回http: named cookie not present的问题，结合Gin框架和iOS Safari的特性，给出以下排查和修复方案：

1. 修正Cookie过期时间的参数错误 #

你当前代码中把未来时间戳传给了maxAge参数，这是核心错误：

• Gin的SetCookie函数第三个参数maxAge是指Cookie从当前时间开始的存活秒数，而非绝对时间戳；
• 正确写法应该用7*24*3600直接表示7天的秒数，替代int(time.Now().Add(7*24*time.Hour).Unix())。

2. 确认HTTPS环境是否正常 #

你的Cookie设置了Secure: true，而SameSite=None模式要求必须搭配HTTPS传输：

• 检查免费主机是否配置了有效SSL证书，确保访问地址以https://开头；
• 多数免费主机支持一键开启HTTPS，优先完成这一步配置，否则iOS Safari会直接忽略带Secure属性的Cookie。

3. 明确指定Cookie的Domain属性 #

代码中Domain参数留空，iOS Safari对未明确指定Domain的Cookie兼容性较差：

• 可以通过c.Request.Host动态获取当前域名，注意去除端口号（如果存在）；
• 若为子域名场景，可设置为根域名（如.your-free-host.com），确保子域名能共享Cookie。

4. 检查Safari隐私设置 #

部分用户的iPhone可能开启了严格的隐私限制：

• 引导用户前往「设置」→「Safari浏览器」→「隐私与安全性」；
• 确保未开启「阻止所有Cookie」，且「智能跟踪预防」未对网站做特殊限制。

修改后的示例代码 #

import "strings"

// 动态获取域名，去除端口号
domain := c.Request.Host
if idx := strings.Index(domain, ":"); idx != -1 {
    domain = domain[:idx]
}
// 本地开发时保留空域名
if domain == "localhost" {
    domain = ""
}

c.SetSameSite(http.SameSiteNoneMode)
// 正确设置maxAge为7天的秒数，明确指定Domain
c.SetCookie("token", personToken, 7*24*3600, "/", domain, true, true)
c.SetCookie("refresh_token", refreshToken, 7*24*3600, "/", domain, true, true)
c.SetCookie("logged_in", "true", 7*24*3600, "/", domain, true, false)

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