求助:Android Studio推送项目至GitHub遇301永久重定向,无法创建同名仓库
解决删除GitHub仓库后推送Android Studio项目时的301重定向错误
我之前帮不少开发者处理过这类问题——你之前删除了GitHub上名为「App Name」的仓库,但本地Git配置或者GitHub的服务器缓存还残留着旧仓库的关联信息,导致现在推送新项目时触发了301永久重定向错误。下面是一步步的解决方案:
1. 检查并修复本地远程仓库地址
首先打开Android Studio底部的Terminal(或者直接用本地的Git Bash工具),切换到你的项目根目录,先查看当前的远程仓库配置:
git remote -v
你大概率会看到输出里的origin地址还是指向那个已经被删除的「App Name」仓库。接下来分两种方式处理:
方式一:直接更新现有远程地址
如果你已经在GitHub上重新创建了同名仓库,把下面的URL替换成你新仓库的实际地址,执行这条命令更新:
git remote set-url origin https://github.com/你的GitHub用户名/App-Name.git
方式二:删除旧远程再重新添加
要是不确定旧地址的具体问题,先删掉旧的远程关联:
git remote remove origin
然后添加新的远程仓库地址:
git remote add origin https://github.com/你的GitHub用户名/App-Name.git
2. 处理GitHub的服务器缓存(更新地址后仍报错的情况)
有时候GitHub会对已删除的仓库保留短暂的重定向缓存,这时候可以试试这两个办法:
- 耐心等10-15分钟,让GitHub的缓存自动过期
- 临时给新仓库起个不同的名字,推送成功后再改回「App Name」(这是兜底方案,一般更新本地地址就能解决)
3. 强制推送(本地有未同步提交时)
如果更新远程地址后还是推送失败,尝试强制推送本地分支到新仓库:
git push -f origin main
⚠️ 注意:-f是强制推送,只有当你确定本地分支是最新版本,且新仓库没有其他开发者的提交时再用,避免覆盖他人的修改。
4. 验证Android Studio的Git配置
有时候Android Studio的VCS配置可能没同步更新,你可以检查一下:
- 打开
File > Settings > Version Control > Git,确认Git的本地路径配置正确 - 进入
File > Settings > Version Control > GitHub,确保你的GitHub账号已正确登录,且仓库列表里能看到新创建的「App Name」仓库 - 最后重新尝试推送:点击顶部菜单栏的
VCS > Git > Push,选择正确的远程仓库和分支
额外提示:如果之前的仓库名称存在大小写差异(比如之前是
app-name,现在想推App Name),GitHub对仓库名称是大小写不敏感的,但本地Git可能会因为大小写不一致触发重定向,这时候更新远程地址时要严格匹配GitHub上的仓库名称(包括大小写)。
内容的提问来源于stack exchange,提问作者Ritika Agarwal




