# \#构建实操

**URL:** https://buildx.do/tag/hands-on/1.md

[最新](https://buildx.do/latest.md) · [类别](https://buildx.do/categories.md) · [标签](https://buildx.do/tags.md)

---

## [测试库和开发库用串了](https://buildx.do/t/%E6%B5%8B%E8%AF%95%E5%BA%93%E5%92%8C%E5%BC%80%E5%8F%91%E5%BA%93%E7%94%A8%E4%B8%B2%E4%BA%86/30)

<div class="topic-metadata">

**Author:** [@gaoyuan](https://buildx.do/u/gaoyuan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 14:18 UTC](https://buildx.do/t/%E6%B5%8B%E8%AF%95%E5%BA%93%E5%92%8C%E5%BC%80%E5%8F%91%E5%BA%93%E7%94%A8%E4%B8%B2%E4%BA%86/30 "2026-10-03T14:18:00Z")

</div>

跑测试之后，开发库里一批手头数据不见了。测试并没有报错，它只是连错了库，把开发数据清掉了。 配置是复制来的，库名少改了一个后缀。测试配置和开发配置看起来只差两个字母。 恢复用的是当天早上的备份，丢的是备份之后新造的数据。能恢复，但那一下很慌。 现在启动测试会先打印当前库名，并且库名里必须带 test。不带就拒绝执行清除。开发库的名字里禁止出现这个标记。 两份配置不再互相复制。示例是第三份文件，各自填自己的值。 这条检查进了测试…

---

## [定时任务提前了八小时](https://buildx.do/t/%E5%AE%9A%E6%97%B6%E4%BB%BB%E5%8A%A1%E6%8F%90%E5%89%8D%E4%BA%86%E5%85%AB%E5%B0%8F%E6%97%B6/32)

<div class="topic-metadata">

**Author:** [@wuqiao](https://buildx.do/u/wuqiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 15:22 UTC](https://buildx.do/t/%E5%AE%9A%E6%97%B6%E4%BB%BB%E5%8A%A1%E6%8F%90%E5%89%8D%E4%BA%86%E5%85%AB%E5%B0%8F%E6%97%B6/32 "2026-10-03T15:22:00Z")

</div>

任务设在本地早上 9 点，实际在凌晨 1 点跑了。报表发到了还没人上班的时间。 机器时区是 UTC，我写的小时数按东八区理解。差正好八小时。代码里没有写时区，用的是机器默认。 改法是在配置里写明时区，任务描述里也写上‘按哪个时区的 9 点’。不要依赖某台机器刚好设对了时区。 日志里的时间同时打 UTC 和配置时区，对报表的人不用心算。 我们把已有的定时任务都对了一遍。还有两个是按 UTC 写的，本来就对，没有改它们的小时数，只补…

---

## [别人拉下去装不上](https://buildx.do/t/%E5%88%AB%E4%BA%BA%E6%8B%89%E4%B8%8B%E5%8E%BB%E8%A3%85%E4%B8%8D%E4%B8%8A/31)

<div class="topic-metadata">

**Author:** [@sunkeqi](https://buildx.do/u/sunkeqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 14:50 UTC](https://buildx.do/t/%E5%88%AB%E4%BA%BA%E6%8B%89%E4%B8%8B%E5%8E%BB%E8%A3%85%E4%B8%8D%E4%B8%8A/31 "2026-10-03T14:50:00Z")

</div>

我这边能跑，同事克隆之后安装失败，缺一个我本地有、仓库里没有的版本。 原因是只提交了依赖清单，没有提交锁文件。他解算到的版本和我昨天装到的不一样，接口已经变了。 把锁文件补进仓库之后，他在干净目录重新安装，版本一致，服务能起来。 说明里写了一句：改依赖后要提交锁文件，并用干净目录装一次当作自检。 干净目录不是删掉整个项目，而是在临时目录克隆再装。这样不会误删自己没提交的改动。 之后‘我这边是好的’少了很多。版本不一致这件事先被…

---

## [两个人同时改表结构](https://buildx.do/t/%E4%B8%A4%E4%B8%AA%E4%BA%BA%E5%90%8C%E6%97%B6%E6%94%B9%E8%A1%A8%E7%BB%93%E6%9E%84/28)

<div class="topic-metadata">

**Author:** [@liweiqi](https://buildx.do/u/liweiqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 13:14 UTC](https://buildx.do/t/%E4%B8%A4%E4%B8%AA%E4%BA%BA%E5%90%8C%E6%97%B6%E6%94%B9%E8%A1%A8%E7%BB%93%E6%9E%84/28 "2026-10-03T13:14:00Z")

</div>

我给表加了一列，另一位同事在同一天重命名了旁边一列。两边本地都迁移成功，合到一起时顺序和列名对不上。 冲突不在业务代码，在两份迁移文件。数据库只能按实际执行过的顺序来，不能按我们心里的顺序。 处理是先确定谁的迁移已经在共享环境跑过。跑过的那份保持文件名不变，另一份改成更晚的时间戳，并按新列名重写。 约定从此写在说明里：要改表结构，先在共享频道发一句文件名，再动手。同时改同一张表就错开，或者结对做一份迁移。 合完之后用一份干净库从…

---

## [日志重启就没了](https://buildx.do/t/%E6%97%A5%E5%BF%97%E9%87%8D%E5%90%AF%E5%B0%B1%E6%B2%A1%E4%BA%86/29)

<div class="topic-metadata">

**Author:** [@huangning](https://buildx.do/u/huangning)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 13:46 UTC](https://buildx.do/t/%E6%97%A5%E5%BF%97%E9%87%8D%E5%90%AF%E5%B0%B1%E6%B2%A1%E4%BA%86/29 "2026-10-03T13:46:00Z")

</div>

故障发生时容器已经重启过，里面的日志文件跟着没了。只记得‘刚才报过错’，没有原文。 原因是日志写在容器可写层里。容器一换，层就丢。我们改成把日志打到标准输出，由外面的收集把标准输出存下来。 也试过挂一个目录到容器里。能留住文件，但要自己处理切割和权限。标准输出这条路更少维护。 每条日志带上时间、级别和请求编号。没有编号的话，一次请求的几行会对不到一起。 重启之后再故意触发一次错误，确认收集端能看到。只改配置、不验证，会在下一次故…

---

## [环境变量容器里是空的](https://buildx.do/t/%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%AE%B9%E5%99%A8%E9%87%8C%E6%98%AF%E7%A9%BA%E7%9A%84/25)

<div class="topic-metadata">

**Author:** [@wanghe](https://buildx.do/u/wanghe)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 11:38 UTC](https://buildx.do/t/%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%AE%B9%E5%99%A8%E9%87%8C%E6%98%AF%E7%A9%BA%E7%9A%84/25 "2026-10-03T11:38:00Z")

</div>

本机 shell 里能读到数据库地址，进容器执行同样的打印却是空字符串。应用启动不报缺变量，只是连到一个不存在的主机。 对比名字之后发现差了一个下划线。本机是 DATABASE\_URL，容器配置里写成了 DATABASEURL。文件看过去几乎一样。 改完名字仍是旧行为，因为进程是改文件之前拉起的。重启容器之后才读到新值。我把这一步写进了修改说明。 启动时只打印变量名和是否为空，不打印值。这样查问题不用把连接串打进日志。 配置样例…

---

## [迁移跑到一半停了](https://buildx.do/t/%E8%BF%81%E7%A7%BB%E8%B7%91%E5%88%B0%E4%B8%80%E5%8D%8A%E5%81%9C%E4%BA%86/24)

<div class="topic-metadata">

**Author:** [@chenmiao](https://buildx.do/u/chenmiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 11:06 UTC](https://buildx.do/t/%E8%BF%81%E7%A7%BB%E8%B7%91%E5%88%B0%E4%B8%80%E5%8D%8A%E5%81%9C%E4%BA%86/24 "2026-10-03T11:06:00Z")

</div>

空库执行全部通过。一换到有半年数据的库，就停在给旧表补列的那一步，错误是某行不满足新约束。 我没有整段重跑。先把失败的语句单独拿出来，用一条查询数出有多少行违反约束。当时是 37 行，都是早期导入、字段为空的记录。 处理是给这 37 行补上约定的默认值，并在迁移里把这一步写成可重复执行。中途失败后再跑，不会因为列已经存在而再次失败。 默认值写在迁移注释里：为什么是这个值，谁在哪天确认的。不然下一个人会当成随便填的。 空库的自动化…

---

## [本地起服务时端口被占了](https://buildx.do/t/%E6%9C%AC%E5%9C%B0%E8%B5%B7%E6%9C%8D%E5%8A%A1%E6%97%B6%E7%AB%AF%E5%8F%A3%E8%A2%AB%E5%8D%A0%E4%BA%86/23)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 10:34 UTC](https://buildx.do/t/%E6%9C%AC%E5%9C%B0%E8%B5%B7%E6%9C%8D%E5%8A%A1%E6%97%B6%E7%AB%AF%E5%8F%A3%E8%A2%AB%E5%8D%A0%E4%BA%86/23 "2026-10-03T10:34:00Z")

</div>

页面打不开，终端写的是 address already in use。我一开始把活动监视器里所有像服务的进程都停了，结果把正在用的数据库图形工具也关掉了。 后来只查 3000。命令是 lsof -nP -iTCP:3000 -sTCP:LISTEN。输出里能看到 pid 和完整命令行，能认出是不是自己上次没退出的进程。 认出来之后才 kill。如果命令是系统服务，就改项目的端口，不杀。我们本地约定应用用 3000，被占了就改 300…

---

## [改了文件页面还是旧的](https://buildx.do/t/%E6%94%B9%E4%BA%86%E6%96%87%E4%BB%B6%E9%A1%B5%E9%9D%A2%E8%BF%98%E6%98%AF%E6%97%A7%E7%9A%84/26)

<div class="topic-metadata">

**Author:** [@suyanran](https://buildx.do/u/suyanran)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 12:10 UTC](https://buildx.do/t/%E6%94%B9%E4%BA%86%E6%96%87%E4%BB%B6%E9%A1%B5%E9%9D%A2%E8%BF%98%E6%98%AF%E6%97%A7%E7%9A%84/26 "2026-10-03T12:10:00Z")

</div>

改完模板刷新了三次，页面不变。我以为是热更新坏了，查了半小时文件监听。 最后看地址栏，端口是 3000，而我改的那份服务跑在 3001。旧进程一直占着 3000，浏览器当然还是旧页面。 关掉旧进程、只留一份之后，修改能在保存后出现。热更新本身没有坏。 为了让这件事一眼能看出来，页面页脚在开发环境打印当前端口和启动时间。两个标签页如果启动时间不同，就是两份进程。 也遇到过真正的缓存。那种情况文件名没变，浏览器继续用旧脚本。开发时可…

---

## [包仓库昨天短暂不可用](https://buildx.do/t/%E5%8C%85%E4%BB%93%E5%BA%93%E6%98%A8%E5%A4%A9%E7%9F%AD%E6%9A%82%E4%B8%8D%E5%8F%AF%E7%94%A8/150)

<div class="topic-metadata">

**Author:** [@chenmiao](https://buildx.do/u/chenmiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 03:48 UTC](https://buildx.do/t/%E5%8C%85%E4%BB%93%E5%BA%93%E6%98%A8%E5%A4%A9%E7%9F%AD%E6%9A%82%E4%B8%8D%E5%8F%AF%E7%94%A8/150 "2026-10-06T03:48:00Z")

</div>

「包仓库昨天短暂不可用」。 构建失败不一定是你的错。过会儿重试，看状态页。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 动态只记会影响我们怎么用的那一部分：默认值变了、接口弃用了、协议变严了、维护窗口在哪天。不抄整份发布说明。升级…

---

## [浏览器一直吃旧脚本](https://buildx.do/t/%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%80%E7%9B%B4%E5%90%83%E6%97%A7%E8%84%9A%E6%9C%AC/33)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 15:54 UTC](https://buildx.do/t/%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%80%E7%9B%B4%E5%90%83%E6%97%A7%E8%84%9A%E6%9C%AC/33 "2026-10-03T15:54:00Z")

</div>

脚本逻辑改了，浏览器里仍是旧行为。强制刷新有时有效，有时又回到旧的。 开发时先确认没有第二份旧服务。确认之后，如果仍是旧脚本，就是缓存。文件地址没变，浏览器认为可以继续用。 正式环境给脚本地址加上内容摘要。内容一变，地址就变，旧缓存用不上。 开发环境可以在浏览器里禁用缓存，但别让同事靠记忆做这件事。页脚打印脚本地址的摘要，两个人对一下就知道是不是同一份。 也遇到过页面是新的、脚本是旧的。那是页面没带上新的摘要。构建要保证页面和脚…

---

## [第一次合进主干全是配置冲突](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E5%90%88%E8%BF%9B%E4%B8%BB%E5%B9%B2%E5%85%A8%E6%98%AF%E9%85%8D%E7%BD%AE%E5%86%B2%E7%AA%81/34)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 16:26 UTC](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E5%90%88%E8%BF%9B%E4%B8%BB%E5%B9%B2%E5%85%A8%E6%98%AF%E9%85%8D%E7%BD%AE%E5%86%B2%E7%AA%81/34 "2026-10-03T16:26:00Z")

</div>

业务代码几乎没有冲突，冲突全在配置：本机数据库地址、端口、一个只在我电脑上存在的路径。 这些值不该进主干。我们留了一份示例配置，真实配置写进忽略列表。每个人从示例复制一份再填。 已经进过主干的真实地址，从最新文件里拿掉，并在说明里写上‘不要再提交’。历史里的旧值如果还敏感，就按密钥那套作废，而不是假装没发生。 合入前看差异时，配置文件单独看一遍。业务代码的冲突可以慢慢对，配置冲突往往是有人把本地值交上来了。 示例文件里的值用明显…

---

## [密钥曾经写进仓库](https://buildx.do/t/%E5%AF%86%E9%92%A5%E6%9B%BE%E7%BB%8F%E5%86%99%E8%BF%9B%E4%BB%93%E5%BA%93/27)

<div class="topic-metadata">

**Author:** [@zhaoan](https://buildx.do/u/zhaoan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 12:42 UTC](https://buildx.do/t/%E5%AF%86%E9%92%A5%E6%9B%BE%E7%BB%8F%E5%86%99%E8%BF%9B%E4%BB%93%E5%BA%93/27 "2026-10-03T12:42:00Z")

</div>

提交前没看差异，把本地配置里的访问密钥一起推了上去。几分钟后才在提交记录里看见。 只删掉最新文件不够。历史里还能把那次提交检出来。我们没有改写所有人的历史，而是立刻把那把密钥作废，换了一把新的。 新密钥只放在本机和部署环境，仓库里改成示例文件，真实文件名写进忽略列表。 提交前多了一项检查：差异里如果出现密钥样式的长字符串，就停下来看。检查是脚本，不是记性。 我把这次经过写成短记录，放在仓库的开发说明里，不写密钥本身，只写‘作废、…
