systemd 服务默认在极简环境中运行，不加载用户 shell 的环境变量（如 GOPATH），导致 go run 因找不到依赖包而失败；解决方法是在 .service 文件中显式声明 Environment=GOPATH=...，并避免在生产环境中直接用 go run 启动服务。
systemd 服务默认在极简环境中运行，不加载用户 shell 的环境变量（如 gopath），导致 `go run` 因找不到依赖包而失败；解决方法是在 `.service` 文件中显式声明 `environment=gopath=...`，并避免在生产环境中直接用 `go run` 启动服务。
在 Linux 系统中，systemd 启动的服务进程不会继承用户登录 shell 的环境变量（如 ~/.zshrc 或 ~/.bashrc 中设置的 GOPATH），而是使用一个最小化的、仅含基础系统路径（如 /usr/bin:/bin）的干净环境。这就是为什么你在终端中执行 /usr/bin/go run /home/denis/goserver/index.go 能成功——此时 shell 已加载了你的 GOPATH；但 systemd 启动同一命令时却报错：
cannot find package "gopkg.in/mgo.v2" in any of:
/usr/lib/go-1.6/src/gopkg.in/mgo.v2 (from $GOROOT)
($GOPATH not set)
错误信息明确指出：$GOPATH not set。这并非 Go 未安装，而是该进程根本“看不见”你手动 export 的变量。
✅ 正确解法：在 service 文件中显式注入环境变量
将你的 goserver.service 修改为：
[Unit] Description=Goserver After=network.target [Service] Type=exec Environment="GOPATH=/home/denis/goserver" Environment="PATH=/usr/local/go/bin:/usr/bin:/bin" WorkingDirectory=/home/denis/goserver ExecStart=/usr/bin/go run index.go Restart=on-failure RestartSec=5 User=denis Group=denis [Install] WantedBy=multi-user.target
关键改动说明：
yuanfang-skills 的共享设计系统，提供 token CSS 变量、12+ 主题以及可复用的布局类型 HTML 块，供 yuanfang-html-image（以及 fu...）使用。
-
Environment="GOPATH=/home/denis/goserver"：强制为该服务进程设置GOPATH，路径需绝对且真实存在（建议提前验证ls /home/denis/goserver/src/gopkg.in/mgo.v2是否存在）； -
Environment="PATH=..."：补充 Go 二进制所在路径（如/usr/local/go/bin），确保go命令可被找到（尤其当go不在/usr/bin/go时）； -
WorkingDirectory：避免路径歧义，使index.go解析更可靠； -
User/Group：以非 root 用户运行，符合最小权限原则，并确保能访问$HOME下的源码与pkg目录； -
Type=exec：适用于一次性执行命令（go run无后台守护进程），若需长期运行请改用Type=simple并配合go build生成二进制。
⚠️ 重要提醒：go run 不适合生产部署
虽然上述配置能让服务“跑起来”，但强烈不推荐在生产环境直接用 go run 启动服务，原因包括：
- ❌ 启动慢：每次启动都触发编译，增加延迟；
- ❌ 无编译检查：若代码存在语法错误或依赖缺失，服务会在启动瞬间崩溃，缺乏预检机制；
- ❌ 安全风险：
go run需读取源码和vendor/或go.mod，若服务目录权限失控，可能意外暴露敏感逻辑； - ❌ 环境耦合强：依赖
GOPATH结构或模块缓存状态，跨机器迁移困难。
✅ 推荐生产实践：构建静态二进制 + systemd 托管
# 1. 在项目根目录构建（自动识别 go.mod 或 GOPATH） $ go build -o goserver . # 2. 将二进制移至标准位置 $ sudo install -m 0755 goserver /usr/local/bin/ # 3. 更新 service 文件（更健壮、更高效） ExecStart=/usr/local/bin/goserver # 删除 Environment=GOPATH 行（二进制已打包全部依赖）
此时 GOPATH 完全无关——Go Modules 编译出的二进制是自包含的，无需运行时查找源码或包缓存。
? 验证技巧（排查必备）：
在 service 中加入调试日志，确认实际环境：
ExecStartPre=/bin/sh -c 'echo "[$(date)] GOPATH=$GOPATH, PATH=$PATH, USER=$USER" >> /tmp/goserver-env.log' ExecStart=/usr/bin/go run index.go
然后查看日志：
$ sudo journalctl -u goserver.service -n 20 --no-pager $ cat /tmp/goserver-env.log
总结：systemd 的环境隔离是特性而非缺陷。解决问题的核心不是“让 systemd 读取我的 .zshrc”，而是主动、显式、可审计地声明服务所需的一切环境。设置 Environment= 是标准、安全、可复现的做法；而迈向 go build + 二进制部署，则是从开发便利走向工程可靠的关键一步。
