Perforce服务器从2017升级到2023后无法创建工作区

问题背景 #

团队将Windows环境下的Perforce服务器从2017.1版本升级至2023.1版本，升级过程顺利，前两周现有客户端均无异常。但在P4V中创建新工作区或更新现有工作区的 depot 映射时，触发以下错误：

无法创建名为''的工作区。客户端规范中'Options'字段第0行出错。'Options'字段的值必须是submitunchanged/submitunchanged+reopen/revertunchanged/revertunchanged+reopen/leaveunchanged/leaveunchanged+reopen之一。

当前客户端规范信息如下：

p4 client 输出结果 #

Client: xyz

Update: 2023/08/10 14:25:09

Access: 2023/08/10 14:25:09

Owner:  abc

Host:   xyz

Description:
    Created by abc.

Root:   c:\Users\User

Options:    submitunchanged

LineEnd:    local

View:
    //depot/... //xyz/...

p4 spec -o client 输出结果 #

Fields:
        301 Client word 32 key
        302 Update date 20 always
        303 Access date 20 always
        304 Owner word 32 optional
        305 Host word 32 optional
        306 Description text 128 optional
        307 Root line 64 required
        308 AltRoots llist 64 optional
        313 Options select 25 optional
        310 LineEnd select 12 optional
        314 Stream line 64 optional
        316 StreamAtChange line 64 optional
        315 ServerID line 64 always
        318 Type select 10 optional
        319 Backup select 10 optional
        311 View wlist 64 optional
        317 ChangeView llist 64 optional

Words:
        View 2

Formats:
        Client 1 normal
        Update 2 L
        Access 4 L
        Owner 3 R
        Host 5 R
        Options 0 L
        LineEnd 0 L

Values:
        Options submitunchanged/submitunchanged+reopen/revertunchanged/revertunchanged+reopen/leaveunchanged/leaveunchanged+reopen
        LineEnd local/unix/mac/win/share
        Type writeable/readonly/graph/partitioned
        Backup enable/disable

此前尝试添加SubmitOptions字段到客户端规范，触发错误：

Error in spec specification. Builtin field cannot be changed.

解决建议 #

1. 统一客户端与服务器版本
   核心问题是旧版本客户端（如原2017.1版本的P4V）与2023.1版本服务器存在兼容性差异，服务器对Options字段的枚举值定义或验证逻辑已更新，旧GUI客户端无法正确适配。需将所有客户端工具（包括P4V、命令行p4工具）升级至与服务器一致的2023.1版本。

2. 临时替代方案（若无法立即全量升级）
   暂时改用命令行工具p4 client修改或创建工作区，命令行工具的跨版本兼容性略优于GUI工具，但仅作为临时过渡，最终仍需统一版本。

其他检查项 #

• 检查客户端规范模板：运行p4 spec client查看默认模板，确认Options字段的可选值与服务器版本匹配。若模板被自定义修改过，可能导致枚举值不兼容，可先备份模板后执行p4 spec -d client重置为默认模板。
• 校验Options字段格式：确保字段值无多余空格或拼写错误，例如submitunchanged为正确格式，避免写成submit unchanged。
• 确认服务器升级完整性：检查服务器所有组件（p4d、p4broker等）均已升级至2023.1版本，查看服务器日志是否存在未完成的升级步骤或异常信息。

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