CVS 提交 "Permission denied" 權限問題全景排查與解決方案

前言

CVS 提交時報錯 cannot rename file ...,v: Permission denied 是經典權限問題。本文系統梳理 5 大典型癥狀、根因與解決方案，適用於 Windows + CVSNT 混合認證環境。

核心原理

CVSNT 混合模式要求：用戶同時是 Windows 用戶和 CVS 用戶，且對倉庫目錄擁有讀寫權限。默認新建 CVS 用戶僅為 Windows 普通用戶，無倉庫寫權限，故可 Checkout 但無法 Commit。

五大典型癥狀與解決

癥狀 1：chacl 不支援

cvs chacl default:n
cvs [chacl aborted]: server does not support chacl

原因：Python 版本與 WinCVS 不兼容
解決：統一使用 Python 2.2.1 + CVSNT 2.0.41 + WinCVS 1.3 中文版

癥狀 2：無法 Checkout 模塊

cvs server: User user4 cannot access lxwDIR

原因：用戶無工作目錄讀寫權限
解決：Windows 資源管理器 → 倉庫目錄屬性 → 安全 → 編輯 → 添加用戶 → 勾選「完全控制」

癥狀 3：無法 Commit 提交

cvs [server aborted]: "commit" requires write access to the repository

原因：用戶未在 CVS `writers` 文件中
解決：編輯倉庫根目錄 CVSROOT/writers，每行添加一個用戶名，保存

癥狀 4：空密碼/授權失敗

cvs add: Empty password used - try 'cvs login' with a real password
cvs [add aborted]: authorization failed: server rejected access for user user2

原因：用戶切換未重新登錄/Checkout
解決：

1. cvs logout
2. 刪除本地 CVS 目錄或重新 Checkout 到新目錄
3. cvs login 輸入正確密碼
4. 再次 Commit

癥狀 5：無權限設置 ACL

cvs [server aborted]: "chacl" requires write access to the repository

原因：非管理員嘗試修改權限
解決：僅倉庫管理員 (Windows Administrators 組) 可執行 chacl

通用修復清單 (按優先級)

1. Windows 權限：CVS 用戶加入倉庫目錄「完全控制」ACL
2. CVS 作者列表：`CVSROOT/writers` 包含所有提交用戶
3. CVS 讀者列表：`CVSROOT/readers` 包含所有只讀用戶 (可選)
4. 用戶組映射：Windows 用戶組 ↔ CVS 角色一一對應
5. 服務賬戶：CVSNT 服務運行賬戶需有倉庫讀寫權限

遷移建議

CVS 已停止維護 15+ 年，缺乏原子提交、分支合併、離線工作等現代版控核心能力。強烈建議遷移至 Git (配合 GitLab/GitHub/Gitea) 或 SVN，可消除 99% 權限疑難雜症並獲得豐富生態工具鏈。

總結

CVS 權限問題本質是 Windows 文件系統 ACL 與 CVS 內部 writers/readers 列表雙重把關。按「系統權限 → CVS 列表 → 用戶映射」三層排查，可解決所有 Permission denied 變體。長期視角請規劃版控遷移，停止在舊工具上投入維護成本。